claude-code-ultimate-guide/machine-readable
Florian BRUNIAUX 3a5012eef7 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>
2026-01-27 16:16:49 +01:00
..
claude-code-releases.yaml docs: track Claude Code v2.1.20 release 2026-01-27 09:02:45 +01:00
cowork-reference.yaml docs: complete Cowork documentation v1.0 (Phase 2) 2026-01-20 11:23:43 +01:00
llms.txt feat: add ecosystem positioning, install script & new commands 2026-01-19 08:42:33 +01:00
README.md refactor: restructure repo into thematic directories v3.1.0 2026-01-13 15:30:02 +01:00
reference.yaml docs: document Tasks API field visibility limitations (Gang Rui analysis) 2026-01-27 16:16:49 +01:00

Machine-Readable References

Files optimized for LLM/AI consumption.

Contents

File Description Tokens
reference.yaml Structured index with line numbers for deep dives ~2K
llms.txt Standard LLM context file for repository indexation ~1.5K

Usage

Give Claude Code instant expertise

# Paste into any AI assistant
curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/machine-readable/reference.yaml

Reference in Claude Code

@machine-readable/reference.yaml

Add to system prompts

Include the YAML content in your AI assistant's system prompt for Claude Code expertise.


Back to main README