Skip to content

tasks skill: write decision question, recommended option and consequences - #78

Merged
calvin-archastro merged 1 commit into
mainfrom
feat/tasks-skill-decision-fields
Oct 21, 2026
Merged

calvin-archastro merged 1 commit into
mainfrom
feat/tasks-skill-decision-fields

Conversation

@calvin-archastro

@calvin-archastro calvin-archastro commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

Review on ArchCode

Merge order: merge after firstlanding #19330 ships in a released archdev CLI. A CLI without it may reject recommended/question as unknown decision fields. Plans written by the old skill keep working on the new CLI.

Problem and author intent

The tasks skill tells planners to put unresolved choices in major_decisions, but its example only shows id, name, description and bare options. #19330 adds decision cards that show a question, a recommended badge and per-option consequences. Without skill guidance, planners will not fill them.

What changed

  • tasks/SKILL.md: the major_decisions example now carries question, recommended and Effect/Cost/Risk lines per option. A short field guide follows the example, including the validation rule (recommended is a 1-based integer within options, and requires options). The gap-triage step tells drafters to use the same fields.
  • plugins/*/skills/tasks/SKILL.md: regenerated with npm run build in tools/plugin-gen (8 harness copies).

Scope, risk, user impact

  • Docs/prompt only. Risk low. A planner that emits recommended against a CLI without #19330 would get an unknown-field error, so merge after #19330 ships in a released CLI.
  • Users get decision cards with a stated question, consequences and a recommendation.

Testing

  • npm run check (140 generated files match) and npm test (116 pass) in tools/plugin-gen.
  • No end-to-end proof: this is skill text, and the rendering boundary is covered by #19330's e2e.

Not installed locally: ~/.agents/skills/tasks stays on the old text until this merges.

🤖 Generated with Claude Code

…on consequences

Plans now fill major_decisions[].question, major_decisions[].recommended
and Effect/Cost/Risk lines in each option, matching the contract in
firstlanding #19330. Plugin copies regenerated with plugin-gen.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@calvin-archastro
calvin-archastro merged commit 787a1d5 into main Oct 21, 2026
20 checks passed
@calvin-archastro
calvin-archastro deleted the feat/tasks-skill-decision-fields branch October 21, 2026 12:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant