\r \r

Human Plan Manager\r

\r Manage short-term plans and detailed implementation schemes in a structured, trackable way.\r \r Who is it for? Anyone who needs to organize tasks, track progress, or document step-by-step execution plans.\r \r What makes it different?\r \r

• Structured: separates high-level overview from detailed implementation\r
• Trackable: uses tables and checkboxes for clear status visibility\r
• Lightweight: just Markdown files, no external tools needed\r \r

Quick Start\r

\r

1. Create plans/plans-overview.md from the overview template\r
2. Add your plan items to the table\r
3. If a plan needs detailed steps, create plans/detailed/XX-{plan-name}.md\r
4. Update plans/detailed/index.md to link the new plan\r
5. Update statuses weekly (or as plans change)\r \r

Directory Structure\r

\r

plans/\r
├── plans-overview.md      ← from templates/plans-overview.md\r
└── detailed/\r
    ├── index.md           ← from templates/index.md\r
    └── XX-{plan-name}.md  ← from templates/detailed-plan.md\r
```\r
\r
## When to Use\r
\r
- Creating a new plan or todo list\r
- Viewing or updating existing plan status\r
- Breaking a plan into detailed steps\r
- Recording detailed implementation documentation\r
- Structured project plan management\r
\r
## Example: Refactoring the Auth Module\r
\r
**Step 1** — Add to `plans/plans-overview.md`:\r
\r
```markdown\r
| 1 ||***|| Auth module refactor ||***|| In Progress ||***|| High ||***|| TBD ||***|| TBD ||***|| Break into service layer |\r
```\r
\r
**Step 2** — Create `plans/detailed/01-auth-refactor.md`:\r
\r
```markdown\r
# Detailed Plan - Auth Module Refactor\r
\r
## Plan ID: #1\r
\r
## Objective\r
Extract auth logic into a dedicated service layer with unit tests.\r
\r
## Schedule\r
TBD\r
\r
## Deadline\r
TBD\r
\r
## Implementation Steps\r
\r
### 1. Extract service layer\r
- [ ] Move auth logic from controllers\r
- [ ] Define service interfaces\r
\r
### 2. Add tests\r
- [ ] Unit tests for login\r
- [ ] Unit tests for token refresh\r
\r
## Estimated Time\r
4-6 hours\r
```\r
\r
**Step 3** — Update `plans/detailed/index.md`:\r
\r
```markdown\r
| #1 | Auth module refactor | TBD | TBD | [01-auth-refactor.md](./detailed/01-auth-refactor.md) |\r
```\r
\r
## Templates\r
\r
All templates live in `templates/`:\r
\r
- **`plans-overview.md`** — High-level plan board with status table and priority lists\r
- **`index.md`** — Index of all detailed plans\r
- **`detailed-plan.md`** — Step-by-step implementation plan with checkboxes\r
\r
## Tips\r
\r
- Keep plan names concise; use kebab-case for filenames (`01-auth-refactor.md`)\r
- Update `last_updated` in frontmatter whenever the overview changes\r
- Use checkboxes (`- [ ]`) in detailed plans to track subtask progress\r
- Archive completed plans by moving them to the "Completed Items" section\r