Skip to content

WIP plan template

Use when a plan moves to active WIP execution with Fibonacci effort tracking. Layout rules: plan-layout.md. Sizing workflow: ../SKILL.md.

When to use

  • Remediation or planning doc is now being executed (not just sized for wall-clock).
  • A *.effort.json sidecar exists beside this markdown file.
  • Progress is updated by editing JSON status + re-running summarize-effort.mjs.

Skeleton

Copy below into docs/wip/{plan-name}.md. Replace {placeholders}. Paste script output where marked — do not hand-calculate totals.

---
doc_classification: wip
status: current
last_reviewed: {YYYY-MM-DD}
owned_by: {Owner Name}
related_docs:
  - docs/wip/{parent-plan}.md
---

# {Plan title}

Sub-plan of [{Parent plan title}](./{parent-plan}.md)  
Status: WIP v0.1  
Owner: {Owner Name}

<!-- PASTE: summarize-effort.mjs --input {plan-name}.effort.json --markdown-top -->

## Recent progress ({YYYY-MM-DD})

{Lead sentence — what was validated or landed.}

- {Evidence bullet}
- {Evidence bullet}
- {Evidence bullet}

{Optional one line: still open for active phase exit criteria.}

## Goal

{One paragraph: desired outcome, primary constraint, and explicit out-of-scope boundary.}

## {First plan-body section — e.g. Decision, Architecture, Phased delivery}

…

## Risks

| Risk | Mitigation |
| --- | --- |
| … | … |

## Open questions

- [ ] …

<!-- PASTE: summarize-effort.mjs --input {plan-name}.effort.json --markdown-breakdown -->

## References

- …

Refresh commands

From the consuming repo (adjust paths):

node library/skills/plan-effort-estimate/scripts/validate-effort.mjs \
  --input docs/wip/{plan-name}.effort.json

node library/skills/plan-effort-estimate/scripts/summarize-effort.mjs \
  --input docs/wip/{plan-name}.effort.json --markdown-top

node library/skills/plan-effort-estimate/scripts/summarize-effort.mjs \
  --input docs/wip/{plan-name}.effort.json --markdown-breakdown

Example

Rendered reference plan (hoen-assessment auth migration):