devton/agentic-workflow-blueprint/plan-writing

agentic-workflows-blueprint.workflow.plan-writing

Goal

Transform a decision log and feature requirements into a structured, dependency-mapped task breakdown saved at docs/tasks/task.<reference>.md.

Scope

• Applies to: Feature design, refactoring tasks, or multi-step execution.
• Does not cover: Direct code execution (use radioactive or execution workflow).

Triggers

• "/plan-writing"
• "Create implementation plan"
• "Generate task breakdown"

Inputs

• decisionLog: Confirmed decisions from discovery.
• projectSlug: Target repo identifier.

Invariants

1. Explicit File Targets: Every task must specify target file paths.
2. Dependency Mapping: Clearly list task prerequisites.
3. Verification Criteria: Include explicit check criteria for each task.
4. Operational Commands Required: Infra/network/IaC/OS tasks must include concrete pre-check, apply/change, verification, and rollback commands.
5. Isolated Task File Path: Save task breakdowns under docs/tasks/task.<reference>.md to avoid root clutter and session overwrites.

Procedure

1. Read decision log and context.
2. Break feature into discrete tasks (simple/medium/complex).
3. Specify dependencies and file paths.
4. Add verification criteria (which tests/checks to run).

• For infra tasks, include command-level verification (terraform plan, connectivity checks, service health checks, policy/security checks).

1. Output plan to docs/tasks/task.<reference>.md artifact.
2. Present plan to user for approval.

Outputs

• docs/tasks/task.<reference>.md artifact containing structured task list.

Review gate

• Plan presents complete task breakdown with dependencies.
• Plan approved by user.

References

• ../../SKILL.md
• ../brainstorming/SKILL.md
• ../radioactive/SKILL.md