Task Ordering & Implementation Rules
Configure Milestone Ordering
Every milestone's task list MUST follow dependency order. Walk through each task and ask: "What must already exist for this to succeed?"
Canonical ordering for a configure milestone:
- Fix system baseline state (broken packages, missing modules)
- Install packages
- Generate keys/credentials (requires package tools like
wg genkey) - Template configuration files (requires generated keys)
- Start/enable services (requires config files)
- Configure runtime state (firewall rules, sysctl, NAT — requires services)
- Persist runtime state (save iptables rules, write generated env file)
Provisioning Milestone Ordering
- For a provisioning milestone:
- Load host-side kernel modules (LXC shares host kernel)
- Upload images/templates
- Create VM/container
- Configure auto-start
- Start VM/container
- Clean template baseline (fix broken packages in LXC)
- Register in dynamic inventory
Dependency Constraint Rules
- NEVER put key generation before package installation. NEVER put service start before configuration. NEVER install packages before fixing broken system state.
Implementation Pattern Specification
Every feature milestone MUST include an implementation pattern note specifying:
- Which task file to create
- Which plays to add to
site.yml - Which tags to use
- Which molecule scenario to create
Never leave "how it integrates" as an open question. Implementation ambiguity causes inconsistent implementations.
Architectural Decision Documentation
- The project plan MUST reference the architectural decisions that were made and WHY, using the tree diagram format from
docs/architecture/overview.md.
Plan Review Execution
Before execution, ALWAYS run the plan through the Plan Review Checklist against all referenced skills. This catches critical issues that would break implementation.
Previous bug: the OpenWrt router plan had two critical issues (SSH auth transition, dynamic group persistence) that would have broken implementation — both caught only by cross-referencing skills during review.