SKILL PLAN · DETERMINISTIC
A small plan for a real job
Start with the minimum useful stack. Add nothing unless it has a clear responsibility in the run.
- Task
- Change planning
- Agent
- Codex
- Priority
- Balanced
Change any option, then update this plan. Rules + reviewed metadata only. No LLM. Same inputs produce the same plan.
01Core execution
Native · Codex
improve-codebase-architecture
Maps files, dependencies, tests, and reference patterns. Open improve-codebase-architecture profile and install guide ↗Review permissions, limitations, and evidence
- Agent fit
- Native · Codex
- Main limitation
- Architecture quality depends on change history and domain context that may be incomplete.
- First risk
- Premature refactoring · Medium
- Source
- Pinned source · c55ee460
02Guardrail
Native · Codex
Repo Intake and Plan
Breaks the change into ordered, testable phases. Open Repo Intake and Plan profile and install guide ↗Review permissions, limitations, and evidence
- Agent fit
- Native · Codex
- Main limitation
- Detailed package files are not fully catalogued.
- First risk
- Review before install · Medium
- Source
- Pinned source · fb3ccdf5
03Evidence
Portable · Codex
build-evidence-map
Records alternatives, consequences, and the evidence behind the choice. Open build-evidence-map profile and install guide ↗Review permissions, limitations, and evidence
- Agent fit
- Portable · Codex
- Main limitation
- Validation proves graph integrity, not source quality or inference correctness.
- First risk
- Sensitive excerpts in portable artifacts · High
- Source
- Pinned source · 1f564408
Core executioncontext-map
- Choose this when
- you want stronger published documentation to start from
- Tradeoff to check
- The workflow is intentionally brief and may miss dynamic dependencies or runtime ownership.
Inspect context-map ↗Guardrailcreate-implementation-plan
- Choose this when
- you want stronger published documentation to start from
- Tradeoff to check
- Demanding zero ambiguity can create oversized plans or false precision for exploratory work.
Inspect create-implementation-plan ↗Evidencecreate-architectural-decision-record
- Choose this when
- you want fewer declared permissions for the same role
- Tradeoff to check
- A fixed template cannot ensure the decision evidence is complete or correct.
Inspect create-architectural-decision-record ↗ Combined permission budget
This is the union of declared permissions across the plan. Review each package before installation.
Review package instructions before installRead repository filesWrite a planRead filesWrite documentsRun commandsNetwork access
Finish with evidence
Produce an implementation-ready plan that reflects the repository's real dependencies.
Planning does not authorize implementation; unresolved assumptions remain visible.
- 3-step acceptance check
- Every phase names its inputs, changed paths, and verification step.
- Dependencies and rollback boundaries are explicit.
- Rejected alternatives include a concrete reason.
- Stop conditions
- The plan assumes files or APIs that were not inspected.
- Implementation begins before critical assumptions are resolved.
- The proposed change has no testable completion condition.