1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# Active Plan: <plan-name>

**Goal**: <one-sentence objective>
**Status**: 🟢 Active / 🟡 Paused / 🔴 Blocked / ✅ Complete
**Created**: YYYY-MM-DD
**Target**: YYYY-MM-DD
**Owner**: hermes-agent / subagent-<id>

## Roadmap

| Phase | Checkpoint | Status | Target | Notes |
|-------|------------|--------|--------|-------|
| 1 | <milestone> | ✅/🟡/⬜ | YYYY-MM-DD | |
| 2 | <milestone> | ⬜ | YYYY-MM-DD | |

## Sub-Steps (Current Phase)

- [ ] <atomic step 1>
- [ ] <atomic step 2>
- [ ] <atomic step 3>

## Blockers

- <blocker description> → <mitigation>

## Decisions Log

| Date | Decision | Rationale |
|------|----------|-----------|
| YYYY-MM-DD | <choice> | <why> |

1
2
3
4
5
6
7

stateDiagram-v2
    [*] --> Draft: Create PROJECT_BRIEF
    Draft --> Active: DEVELOPMENT_PLAN approved
    Active --> Paused: Blocker / priority shift
    Paused --> Active: Blocker resolved
    Active --> Complete: All requirements ✅
    Complete --> Archived: Move to SESSION_LOG

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

# Project Brief: <name>

## Vision
<One paragraph: what this becomes when done>

## Success Criteria
- [ ] <measurable outcome 1>
- [ ] <measurable outcome 2>
- [ ] <measurable outcome 3>

## Scope

### In Scope
- <feature 1>
- <feature 2>

### Out of Scope
- <explicit exclusion 1>
- <explicit exclusion 2>

## Constraints
| Constraint | Detail |
|------------|--------|
| Technical | <stack, platform, performance> |
| Timeline | <deadline or cadence> |
| Resources | <compute, budget, human> |
| Compliance | <privacy, security, legal> |

## Stakeholders
| Role | Name | Input Required |
|------|------|----------------|
| Owner | @🏝🏄 | Final approval |
| Operator | hermes-agent | Execution |
| Reviewer | <subagent> | Verification |

## Risks
| Risk | Likelihood | Impact | Mitigation |
|------|------------|--------|------------|
| <risk> | High/Med/Low | High/Med/Low | <action> |

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# Development Plan: <project-name>

## Phases

### Phase 1: Foundation (Week 1-2)
**Priority**: Critical
**Risk**: Low
**Deliverables**:
- [ ] <core component 1>
- [ ] <core component 2>

### Phase 2: Core Features (Week 3-4)
**Priority**: High
**Risk**: Medium
**Deliverables**:
- [ ] <feature 1>
- [ ] <feature 2>

### Phase 3: Polish & Deploy (Week 5)
**Priority**: Medium
**Risk**: Low
**Deliverables**:
- [ ] <integration>
- [ ] <documentation>
- [ ] <deploy>

## Architecture Decisions

| Decision | Options Considered | Chosen | Rationale |
|----------|-------------------|--------|-----------|
| <topic> | A, B, C | B | <why> |

## Technical Debt Budget
- **Allocated**: 20% of phase time
- **Tracking**: FEEDBACK-LOG entries tagged `tech-debt`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# REQ-<id>: <title>

**As a** <role>
**I want** <capability>
**So that** <benefit>

## Acceptance Criteria

### Scenario: <happy path>
Given <precondition>
When <action>
Then <observable outcome>
And <another outcome>

### Scenario: <edge case>
Given <precondition>
When <action>
Then <error handling>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

# REQ-001: LLM Wiki Architecture Pages

**As a** system architect
**I want** comprehensive architecture documentation in the wiki
**So that** the system is self-describing and onboards new agents

## Acceptance Criteria

### Scenario: All 7 layers documented
Given the wiki is deployed
When I navigate to /architecture/
Then I see all 7 layer pages
And each page has cross-references
And navigation works

### Scenario: Live site reflects changes
Given I edit a content file
When deploy runs
Then https://llm-wiki.0rk.de/architecture/ shows updates

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

# Tasks: <project-name>

## TASK-001: Create architecture/_index.md
**Requirement**: REQ-001
**Status**: ✅ Complete
**Verification**: `ls content/architecture/_index.md`
**Handle**: File created at content/architecture/_index.md

## TASK-002: Create identity-anchors section
**Requirement**: REQ-001
**Status**: 🟡 In Progress
**Verification**: `ls content/architecture/identity-anchors/`
**Handle**: Dir exists with 7 component pages

## TASK-003: Update config.toml menu
**Requirement**: REQ-001
**Status**: ⬜ Pending
**Verification**: `grep -A20 "menu.main" config.toml | grep Architecture`
**Handle**: Menu entry added

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

def verify_task(task):
    # Run verification command
    result = subprocess.run(task.verification, shell=True, capture_output=True)
    assert result.returncode == 0, f"Verification failed: {result.stderr}"
    
    # Verify handle exists
    if task.handle.startswith("File:"):
        assert os.path.exists(task.handle[5:]), "File handle missing"
    elif task.handle.startswith("URL:"):
        assert requests.get(task.handle[4:]).status_code == 200, "URL handle dead"
    elif task.handle.startswith("HTTP:"):
        # Already verified above
        pass