docs: document Tasks API field visibility limitations (Gang Rui analysis)
Integration of community practitioner feedback on Tasks API (v2.1.16+) field visibility constraints discovered through real-world usage. Changes: - guide/ultimate-guide.md: * Added 3 rows to comparison table (field visibility, metadata, overhead) * New subsection "⚠️ Tasks API Limitations (Critical)" (~40 lines) * Field visibility constraint table, cost examples, 3 workaround patterns - guide/workflows/task-management.md: * New subsection "⚠️ Field Visibility Limitations" (~35 lines) * Workflow adjustments, cost awareness, mitigation strategies - guide/cheatsheet.md: * Added limitation note with actionable tip (~3 lines) - machine-readable/reference.yaml: * 4 new entries: limitations, field_visibility, cost_overhead, workarounds * Updated resource_evaluations_count: 16 → 22 - docs/resource-evaluations/016-gang-rui-tasks-api-limitations.md: * New comprehensive evaluation (score 5/5 CRITICAL) * Fact-check, challenge phase, integration details - README.md: * Updated resource evaluations count: 15 → 22 assessments Score: 5/5 (CRITICAL) - Breaks recommended workflow, 11x-51x cost overhead, prevents user frustration, maintains guide credibility. Source: https://www.linkedin.com/posts/limgangrui_i-explored-the-new-claude-codes-task-system-activity-7420651412881268736-Hpd6 Date: 2026-01-24 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
parent
edf74b38c5
commit
3a5012eef7
7 changed files with 493 additions and 10 deletions
|
|
@ -138,7 +138,11 @@ deep_dive:
|
|||
tasks_api_configuration: 3180
|
||||
tasks_api_schema: 3195
|
||||
tasks_api_when_to_use: 3210
|
||||
todowrite_legacy: 3220
|
||||
tasks_api_limitations: 3195
|
||||
tasks_api_field_visibility: "TaskList: id/subject/status/owner/blockedBy only. TaskGet: all fields."
|
||||
tasks_api_cost_overhead: "Reviewing N task descriptions = 1 + N API calls"
|
||||
tasks_api_workarounds: 3210
|
||||
todowrite_legacy: 3260
|
||||
todowrite_when_to_use: 3230
|
||||
todowrite_migration_flag: 3240
|
||||
task_best_practices: 3250
|
||||
|
|
@ -246,7 +250,7 @@ deep_dive:
|
|||
gsd_note: "Overlap with existing patterns (Ralph Loop, Gas Town, BMAD)"
|
||||
# Resource Evaluations (added 2026-01-26)
|
||||
resource_evaluations_directory: "docs/resource-evaluations/"
|
||||
resource_evaluations_count: 16
|
||||
resource_evaluations_count: 22
|
||||
resource_evaluations_methodology: "docs/resource-evaluations/README.md"
|
||||
resource_evaluations_appendix: "guide/ultimate-guide.md:15034"
|
||||
resource_evaluations_readme_section: "README.md:278"
|
||||
|
|
@ -713,10 +717,14 @@ ecosystem:
|
|||
everything_claude_code:
|
||||
url: "github.com/affaan-m/everything-claude-code"
|
||||
author: "Affaan Mustafa (Anthropic hackathon winner - Zenith project)"
|
||||
focus: "Distribution - Plugin-ready configs collection"
|
||||
stars: "16k+"
|
||||
focus: "Production configs - Battle-tested from 10+ months intensive use"
|
||||
stars: "31.9k"
|
||||
verified: "2026-01-27"
|
||||
created: "2026-01-18"
|
||||
unique: ["Node.js cross-platform hooks", "15 MCP configs", "Plugin marketplace format"]
|
||||
unique: ["mgrep (50% token reduction)", "hookify (conversational hooks)", "pass@k metrics", "Plugin ecosystem", "Sandboxed subagents"]
|
||||
evaluation: "docs/resource-evaluations/015-everything-claude-code-github-repo.md"
|
||||
score: "5/5 (CRITICAL)"
|
||||
positioning: "Complementary to Ultimate Guide (production configs vs educational content)"
|
||||
note: "Consolidates existing patterns; author hackathon win was for Zenith project, not this repo"
|
||||
caveat: "Node.js hooks not officially recommended by Anthropic (shell preferred)"
|
||||
coding_agents_matrix:
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue