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:
Florian BRUNIAUX 2026-01-27 16:16:49 +01:00
parent edf74b38c5
commit 3a5012eef7
7 changed files with 493 additions and 10 deletions

View file

@ -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: