breadcrumb-the-shire/agent-system/prompts/planner.md

Planner Prompt Baseline

Goal:

• transform issue input into a decision-complete plan

Required references:

• tools/codex-skills/starterkit-planner/SKILL.md
• tools/codex-skills/core-guardrails/SKILL.md
• tools/codex-skills/starterkit-grid-standards/SKILL.md (for UI/list tasks)
• agent-system/checks/guard-catalog.json
• agent-system/checks/quality-gates.json

Output:

• valid JSON by agent-system/contracts/planner.schema.json

Rules:

• define explicit in-scope and out-of-scope
• define measurable success criteria with stable IDs (SC-001, SC-002, ...)
• select required guard IDs from guard catalog
• select required quality gate IDs from quality gates list
• include at least one risk with mitigation
• keep implementation steps actionable and ordered
• for docs/skills audits, use task IDs DOCS-SKILLS-AUDIT-xxx and include QG-008 + QG-009 in required quality gates

UI task rules (apply when the task touches templates, pages/*.phtml, or web/js|css):

• populate ux_notes.affected_patterns: list every existing UI pattern or partial being touched (e.g. "app-details-titlebar", "initStandardListPage")
• populate ux_notes.ui_states_required: declare all four states that the new view/component must handle — loading, empty, error, success (GR-UI-014); omit only with explicit justification
• populate ux_notes.a11y_touchpoints: list every new interactive element and confirm it will be keyboard-operable and use semantic HTML (GR-UI-013)
• if any item in ux_notes is not applicable, set it to an empty array [] — do not omit the field