plan — Skillopedia

$plan - Issue-Ready Decomposition Quick ref: turn a goal or research artifact into , optional bd issues, dependency waves, file ownership, and validation checks. Execute this workflow. Do not only describe it. Keep planning separate from implementation. A finished plan should let , , or a future Codex session execute without chat-only context. Inputs And Flags Given : | Flag | Purpose | |------|---------| | | Skip the human approval gate for and other autonomous chains | | | Force the minimal 1-2 issue plan shape | | | Force symbol-level/deep plan detail | | | Skip symbol verification for gre…

\"\ncheck \"SKILL.md has name: plan\" \"grep -q '^name: plan' '$SKILL_DIR/SKILL.md'\"\ncheck \"references/ directory exists\" \"[ -d '$SKILL_DIR/references' ]\"\ncheck \"references/ has at least 2 files\" \"[ \\$(ls '$SKILL_DIR/references/' | wc -l) -ge 2 ]\"\ncheck \"SKILL.md mentions .agents/plans/ output path\" \"grep -q '\\.agents/plans/' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions compiled planning rules\" \"grep -q '\\.agents/planning-rules' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions finding registry fallback\" \"grep -q 'registry.jsonl' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions active findings\" \"grep -qi 'active findings' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md requires applied finding IDs in plan context\" \"grep -q 'Applied findings:' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions waves\" \"grep -qi 'wave' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions dependencies\" \"grep -qi 'dependencies\\|depend' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md requires Codex companion scope\" \"grep -q 'Generated Artifact Companion Scope' '$SKILL_DIR/SKILL.md' && grep -q 'refresh-codex-artifacts.sh --scope worktree' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md requires full touched-file inventory\" \"grep -q 'list every touched file' '$SKILL_DIR/SKILL.md' && grep -q 'tests, docs, schemas, fixtures' '$SKILL_DIR/SKILL.md' && grep -q 'parity manifests, hash markers' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions bd for issue tracking\" \"grep -q 'bd ' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions task tracking\" \"grep -qi 'task\\|tracking\\|bd ' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions conformance checks\" \"grep -qi 'conformance' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions --auto flag\" \"grep -q '\\-\\-auto' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions Explore agent\" \"grep -qi 'explore' '$SKILL_DIR/SKILL.md'\"\n\necho \"\"; echo \"Results: $PASS passed, $FAIL failed\"\n[ $FAIL -eq 0 ] && exit 0 || exit 1\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":2254,"content_sha256":"e6604da11322b7f11b6a31f5201427e2236878fd1806acfb2c33fe17a759ede2"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"$plan - Issue-Ready Decomposition","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Quick ref: turn a goal or research artifact into ","type":"text"},{"text":".agents/plans/*.md","type":"text","marks":[{"type":"code_inline"}]},{"text":", optional bd issues, dependency waves, file ownership, and validation checks.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Execute this workflow. Do not only describe it.","type":"text","marks":[{"type":"strong"}]},{"text":" Keep planning separate from implementation. A finished plan should let ","type":"text"},{"text":"$crank","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"$implement","type":"text","marks":[{"type":"code_inline"}]},{"text":", or a future Codex session execute without chat-only context.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Inputs And Flags","type":"text"}]},{"type":"paragraph","content":[{"text":"Given ","type":"text"},{"text":"$plan \u003cgoal> [--auto]","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Flag","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Purpose","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--auto","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Skip the human approval gate for ","type":"text"},{"text":"$rpi","type":"text","marks":[{"type":"code_inline"}]},{"text":" and other autonomous chains","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--fast-path","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Force the minimal 1-2 issue plan shape","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--deep","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Force symbol-level/deep plan detail","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--skip-symbol-check","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Skip symbol verification for greenfield plans","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--skip-audit-gate","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Skip baseline audit gate for docs-only plans","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"If bd is unavailable, still write the markdown plan in ","type":"text"},{"text":".agents/plans/","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Discovery Boundary","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the ","type":"text"},{"text":"Skill Ports and Adapters","type":"text","marks":[{"type":"link","attrs":{"href":"../../docs/contracts/skill-ports-and-adapters.md","title":null}}]},{"text":" vocabulary for the boundary from Discovery into Plan:","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Boundary piece","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Plan contract","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Inbound port","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"plan_slices","type":"text","marks":[{"type":"code_inline"}]},{"text":" from BDD intent, bead, research artifact, or execution packet","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Outbound ports","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"persist_issue","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"verify_symbols","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"retrieve_context","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"seed_execution_packet","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Driving adapter","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"$plan","type":"text","marks":[{"type":"code_inline"}]},{"text":" skill invocation","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Driven adapters","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"bd, ","type":"text"},{"text":"rg","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":".agents/findings","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":".agents/plans","type":"text","marks":[{"type":"code_inline"}]},{"text":", execution-packet writer","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Context packet","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"slice plan, file dependency matrix, acceptance criteria, test levels","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Guard adapter","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"stale-scope verification, symbol verification, wave-validity check","type":"text"}]}]}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"gherkin"},"content":[{"text":"Feature: Plan converts dense intent into executable slices\n Scenario: Plan consumes Discovery output\n Given Discovery provides density fields and artifact links\n When Plan receives the `plan_slices` port request\n Then each slice has acceptance criteria, write scope, test levels, and ownership\n And no slice depends on raw Discovery chat context","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Workflow","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Pre-flight stale bead scope.","type":"text","marks":[{"type":"strong"}]},{"text":" If the input is a bead ID and the work is full-complexity, older than 7 days, or inherited from another session, run ","type":"text"},{"text":"ao beads verify \u003cbead-id>","type":"text","marks":[{"type":"code_inline"}]},{"text":" before decomposition. Do not plan against stale citations without revalidation.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Set up artifacts.","type":"text","marks":[{"type":"strong"}]},{"text":" Create ","type":"text"},{"text":".agents/plans/","type":"text","marks":[{"type":"code_inline"}]},{"text":" and locate prior research, handoffs, findings, planning rules, and relevant ","type":"text"},{"text":".agents/","type":"text","marks":[{"type":"code_inline"}]},{"text":" history.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Load prevention context.","type":"text","marks":[{"type":"strong"}]},{"text":" Prefer ","type":"text"},{"text":".agents/planning-rules/*.md","type":"text","marks":[{"type":"code_inline"}]},{"text":"; fall back to ","type":"text"},{"text":".agents/findings/registry.jsonl","type":"text","marks":[{"type":"code_inline"}]},{"text":". Treat active findings as hard planning context. Record applied finding IDs in the plan with an ","type":"text"},{"text":"Applied findings:","type":"text","marks":[{"type":"code_inline"}]},{"text":" line, even when the value is ","type":"text"},{"text":"none","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Recommend a strategic duel when warranted.","type":"text","marks":[{"type":"strong"}]},{"text":" If the plan spans more than one execution session and has at least one contested operator-default decision, recommend the dueling-idea-wizards route (","type":"text"},{"text":"$council --mode=debate --focus=ideas","type":"text","marks":[{"type":"code_inline"}]},{"text":") before decomposition. Keep it advisory, not mandatory. Skip it for single-session or non-contested plans. Evidence from the 2026-05-17 Mt Olympus run: roughly 22 min wall-clock, 3/5 operator defaults flipped, and one already-shipped adapter bug surfaced.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Explore only as needed.","type":"text","marks":[{"type":"strong"}]},{"text":" If prior research does not provide enough file and symbol detail, inspect the codebase or dispatch a bounded explorer. Demand file inventory, symbol names, reuse points with ","type":"text"},{"text":"file:line","type":"text","marks":[{"type":"code_inline"}]},{"text":", test locations, and package/import relationships.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Baseline audit.","type":"text","marks":[{"type":"strong"}]},{"text":" Mechanically count the current state before making quantitative claims: files, sections, LOC, tests, fixtures, schemas, and any SKILL.md files near size limits. Record commands and results.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Choose detail level.","type":"text","marks":[{"type":"strong"}]},{"text":" Minimal for 1-2 simple issues, Standard for 3-6 issues, Deep for 7+ issues, broad refactors, or ","type":"text"},{"text":"--deep","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Decompose into issues.","type":"text","marks":[{"type":"strong"}]},{"text":" Each issue needs title, file ownership, dependencies, acceptance criteria, test levels, and at least one mechanical conformance check (","type":"text"},{"text":"files_exist","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"content_check","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"command","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"tests","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"lint","type":"text","marks":[{"type":"code_inline"}]},{"text":"). Feature, bug, and product-facing behavior issues also need a fenced ","type":"text"},{"text":"gherkin","type":"text","marks":[{"type":"code_inline"}]},{"text":" block or a link to the upstream intent issue scenario. Non-trivial plans and bead bodies should include the ","type":"text"},{"text":"hexagon:","type":"text","marks":[{"type":"code_inline"}]},{"text":" boundary block: inbound port, bounded context, adapters, context packet, and done state.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Compute waves.","type":"text","marks":[{"type":"strong"}]},{"text":" Group independent issues by dependency. Serialize or merge same-file writes. Include generated artifacts, docs, schemas, fixtures, Codex companions, manifests, and hash markers in ownership. Generated Artifact Companion Scope is mandatory: list every touched file, including tests, docs, schemas, fixtures, runtime copies, parity manifests, hash markers, and generated Codex artifacts. If skill behavior or runtime UX changes, include ","type":"text"},{"text":"bash scripts/refresh-codex-artifacts.sh --scope worktree","type":"text","marks":[{"type":"code_inline"}]},{"text":" in verification.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Write the plan.","type":"text","marks":[{"type":"strong"}]},{"text":" Use ","type":"text"},{"text":".agents/plans/YYYY-MM-DD-\u003cgoal-slug>.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" and the template in ","type":"text"},{"text":"references/plan-document-template.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/plan-document-template.md","title":null}}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Create tracking tasks.","type":"text","marks":[{"type":"strong"}]},{"text":" Prefer bd issues with validation blocks and dependency edges. If bd is missing, leave the markdown plan as the durable handoff.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Approval gate.","type":"text","marks":[{"type":"strong"}]},{"text":" Skip only with ","type":"text"},{"text":"--auto","type":"text","marks":[{"type":"code_inline"}]},{"text":"; otherwise ask whether to proceed, revise, or return to research.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Required Plan Sections","type":"text"}]},{"type":"paragraph","content":[{"text":"Every non-trivial plan must include:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"context and applied findings","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"files to modify","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"boundaries and non-goals","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"baseline audit evidence","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"issue list with acceptance criteria and validation","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"execution order/waves","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"file dependency matrix","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"file-conflict matrix","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"cross-wave shared file registry when applicable","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"planning rules compliance","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"verification commands","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"next steps","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Read ","type":"text"},{"text":"references/plan-document-template.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/plan-document-template.md","title":null}}]},{"text":" for the canonical shape.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Codex Guardrails","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Keep WHAT and HOW distinct; do not implement while planning.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Prefer concrete file paths, symbol names, and validation commands over long narrative.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Treat Codex companion files as part of the same issue when skill behavior or runtime UX changes.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If a plan changes a schema with ","type":"text"},{"text":"additionalProperties: false","type":"text","marks":[{"type":"code_inline"}]},{"text":", put schema work before consumers in an earlier wave.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If an acceptance criterion cannot be checked mechanically, mark it underspecified before handing it to execution.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"User says:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"$plan \"add rate limiting\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" Produce a plan with file inventory, issues, validation, and wave order.","type":"text"}]},{"type":"paragraph","content":[{"text":"User says:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"$plan --auto \".agents/research/auth.md\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" Use the research as input, write the plan, create tracking tasks when possible, and skip the approval gate.","type":"text"}]},{"type":"paragraph","content":[{"text":"Read ","type":"text"},{"text":"references/examples.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/examples.md","title":null}}]},{"text":" for full examples.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Troubleshooting","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Problem","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Response","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"bd is missing","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Write the markdown plan and note that issue creation was skipped","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Prior research is thin","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Explore enough to produce file and symbol evidence","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Same file appears in parallel issues","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Serialize or merge those issues before handoff","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Baseline audit is missing","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Mark the plan incomplete unless ","type":"text"},{"text":"--skip-audit-gate","type":"text","marks":[{"type":"code_inline"}]},{"text":" is justified","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference Documents","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/complexity-estimation.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/complexity-estimation.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/decomposition.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/decomposition.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/detail-templates.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/detail-templates.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/examples.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/examples.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/implementation-detail.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/implementation-detail.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/plan-document-template.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/plan-document-template.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/plan-mutations.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/plan-mutations.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/plan-to-beads-workflow.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/plan-to-beads-workflow.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/planning-rules.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/planning-rules.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/pre-decomposition.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/pre-decomposition.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/sdd-patterns.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/sdd-patterns.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/task-creation.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/task-creation.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/templates.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/templates.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/wave-matrices.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/wave-matrices.md","title":null}}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}}]},"metadata":{"date":"2026-06-05","name":"plan","author":"@skillopedia","source":{"stars":375,"repo_name":"agentops","origin_url":"https://github.com/boshu2/agentops/blob/HEAD/skills-codex/plan/SKILL.md","repo_owner":"boshu2","body_sha256":"457c2f6c2756b2940a27d56fccd319a39fbac16d8a5b1a0b816146633ded9498","cluster_key":"f67d9d3315401ce8025778510872f03fd4efb793c5e676a76532f434d98e9f39","clean_bundle":{"format":"clean-skill-bundle-v1","source":"boshu2/agentops/skills-codex/plan/SKILL.md","attachments":[{"id":"1c632b64-f716-5ba5-acbf-bbc69b634013","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/1c632b64-f716-5ba5-acbf-bbc69b634013/attachment.json","path":".agentops-generated.json","size":268,"sha256":"3f070f5c2054601fea18d8fe9bb7084f4b8144bb59c4e692b9042f4467b58211","contentType":"application/json; charset=utf-8"},{"id":"ac1b603c-78f4-598a-a0c7-351d953f9c1f","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/ac1b603c-78f4-598a-a0c7-351d953f9c1f/attachment.md","path":"prompt.md","size":518,"sha256":"d8e972a49d9081ce6911e36f78187357d693af8c69258bcaaff58de8e6a8156b","contentType":"text/markdown; charset=utf-8"},{"id":"4e6f2b04-1dcf-567f-9985-3f23a090a240","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/4e6f2b04-1dcf-567f-9985-3f23a090a240/attachment.md","path":"references/complexity-estimation.md","size":1179,"sha256":"ab1312fece8c05750a908881a451cc381f62d876d44a8b65bcd5af4dd06c5e85","contentType":"text/markdown; charset=utf-8"},{"id":"907cad9a-6453-55da-96fb-7383650dad74","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/907cad9a-6453-55da-96fb-7383650dad74/attachment.md","path":"references/decomposition.md","size":4843,"sha256":"c8f52f1b492508af2eeb8c17f1d35fd6b05834c29ebb9b0828cc31a0d4b5fa36","contentType":"text/markdown; charset=utf-8"},{"id":"cc278c3e-7528-582e-92df-3e4818d3d1aa","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/cc278c3e-7528-582e-92df-3e4818d3d1aa/attachment.md","path":"references/detail-templates.md","size":1777,"sha256":"896c90853dea2598353c757282b182f2cb7158843e2569efe2501d2a46ec4c4d","contentType":"text/markdown; charset=utf-8"},{"id":"1666fe2f-51b5-5850-9931-db9f5dea0dcc","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/1666fe2f-51b5-5850-9931-db9f5dea0dcc/attachment.md","path":"references/examples.md","size":3276,"sha256":"e9d81b6941122a0f277e6e0897e0e80a98860da615a3b414c2b13184ba0f0003","contentType":"text/markdown; charset=utf-8"},{"id":"8f6e80cc-597f-55d8-827b-8786fd98f72a","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/8f6e80cc-597f-55d8-827b-8786fd98f72a/attachment.md","path":"references/implementation-detail.md","size":5546,"sha256":"bcbed3d0665cec59dd43303cc114be0ff46d74ec248381f1a2816b98d92a7be8","contentType":"text/markdown; charset=utf-8"},{"id":"c5135638-eb6e-57ba-9570-141ba6644117","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/c5135638-eb6e-57ba-9570-141ba6644117/attachment.md","path":"references/plan-document-template.md","size":8570,"sha256":"b06363b68b8a94b4270d50c1c4c75f22adcdf99bd620c50541dd42276b713623","contentType":"text/markdown; charset=utf-8"},{"id":"d7a49e6d-62e8-52c4-aa3e-fe78e75f0a81","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/d7a49e6d-62e8-52c4-aa3e-fe78e75f0a81/attachment.md","path":"references/plan-mutations.md","size":5461,"sha256":"a95f38a16331fc1745b629795250c3b2d3f8fea9bd499a7300878e46a325c655","contentType":"text/markdown; charset=utf-8"},{"id":"c99cd4d9-27ae-5f16-9451-10b6e86b8c44","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/c99cd4d9-27ae-5f16-9451-10b6e86b8c44/attachment.md","path":"references/plan-to-beads-workflow.md","size":1349,"sha256":"8f304db1fe2d6d665536abde5d3623a530dbe2eaa4b8df3637e0dbddecafb8a3","contentType":"text/markdown; charset=utf-8"},{"id":"f6997a1a-690a-596a-9fe4-7cd059019440","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/f6997a1a-690a-596a-9fe4-7cd059019440/attachment.md","path":"references/planning-rules.md","size":9359,"sha256":"4b6ca9662709d71aec0406b5dd13989cd57e7fcda951c20590a04ce2000ff5e3","contentType":"text/markdown; charset=utf-8"},{"id":"fc4e1573-8cca-5960-b0cf-437a1946dcd0","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/fc4e1573-8cca-5960-b0cf-437a1946dcd0/attachment.md","path":"references/pre-decomposition.md","size":7011,"sha256":"15570b605020dc8ede92b87fe0e6aa941d26c03025f238cad4334a816f2bf77e","contentType":"text/markdown; charset=utf-8"},{"id":"fff4deb7-9452-5184-ab23-18c66024201e","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/fff4deb7-9452-5184-ab23-18c66024201e/attachment.md","path":"references/sdd-patterns.md","size":10930,"sha256":"130e89d3d0f52c96c79fdcdcdb3efb39b49d1c217402f6df2d6abdb762f699e1","contentType":"text/markdown; charset=utf-8"},{"id":"982f7afb-5221-549d-bc42-bdd35751c6fe","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/982f7afb-5221-549d-bc42-bdd35751c6fe/attachment.md","path":"references/task-creation.md","size":2930,"sha256":"d8d078e3caccce0824d45347ec7de3d2f0485622ff5bd9abd64894d8b3465da0","contentType":"text/markdown; charset=utf-8"},{"id":"e1ee86f9-ff86-51e4-95af-f5bec5c0d1af","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/e1ee86f9-ff86-51e4-95af-f5bec5c0d1af/attachment.md","path":"references/templates.md","size":12195,"sha256":"73e4d38fdf27fb28f1c24d2eefe89fe42fca0d0f4bb26e9a70b4cbb564c778c8","contentType":"text/markdown; charset=utf-8"},{"id":"79117dfd-a8a2-5a43-b7b8-de68122913f4","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/79117dfd-a8a2-5a43-b7b8-de68122913f4/attachment.md","path":"references/wave-matrices.md","size":4410,"sha256":"056c8a028e3e93f61e6cd1db1173a85b0ad466a3663aaf2388de44eabd2ce6fc","contentType":"text/markdown; charset=utf-8"},{"id":"90a28de2-8114-515d-b7f1-eba8129f174e","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/90a28de2-8114-515d-b7f1-eba8129f174e/attachment.sh","path":"scripts/validate.sh","size":2254,"sha256":"e6604da11322b7f11b6a31f5201427e2236878fd1806acfb2c33fe17a759ede2","contentType":"application/x-sh; charset=utf-8"}],"bundle_sha256":"9738108bccf459e3de10d20f3207b5aa29202ab71414ea4ae766cff4c556aade","attachment_count":17,"text_attachments":17,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":"skills-codex/plan/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"software-engineering","category_label":"Engineering"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"software-engineering","import_tag":"clean-skills-v1","description":"Decompose goals into issue plans."}},"renderedAt":1782980731105}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.