16gagent/protocol-reference/templates.md

Templates — Block / Replan / Audit / Portfolio / Dashboard / Recovery

Full template examples extracted from GOVERNANCE.md and PORTFOLIO.md. Main protocol files reference these by path instead of inlining.

---

progress.log Heartbeat

{"ts":"YYYY-MM-DDTHH:mm:ss+08:00","status":"IN_PROGRESS","completed":["T1"],"remaining":["T2","T3"],"risk":"","next_action":"execute T2"}

blocker.md

# Blocker
- **blocker**: <一句话描述>
- **root_cause**: <根本原因>
- **owner**: <负责人>
- **mitigation**: <缓解方案>
- **dependency**: <依赖>
- **created_at**: <ISO-8601>
- **resolved_at**: <可选>
- **escalated**: <YES/NO>

execution-audit.md

# Execution Audit — YYYY-MM-DD

## Summary
- completion_rate: XX%
- blocked_rate: XX%
- stale_rate: XX%
- failure_rate: XX%
- replan_count: N
- avg_cycle_time: Xh

## Task Status Matrix
| Agent-ID | Task ID | Status | Last Heartbeat | Cycle Time |
|----------|---------|--------|---------------|------------|
| AP-01 | T1 | IN_PROGRESS | YYYY-MM-DD HH:mm | — |

## Blockers (Active)
| Blocker | Owner | Age | Escalated |
|---------|-------|-----|-----------|

## Replans
### Replan #N (YYYY-MM-DD HH:mm)
- trigger: <R1–R8>
- cause: <原因>
- before: <原始>
- after: <修订>
- impact: <影响>

## Health Score
- Delivery: X | Quality: X | Parallelism: X | Dependency: X | Learning: X
- Final: XX → <Rating>

recovery-report.md

# Recovery Report
- trigger: <A1/A2/A3>
- entered_at: <ISO-8601>

## Failed
| Agent-ID | Task | Failure Count | Root Cause |

## Blocked
| Agent-ID | Task | Blocked Since | Blocker |

## Root Cause Chain
1. <首次偏差>
2. <累积效应>
3. <触发点>

## Recovery Plan
| Task ID | Name | Depends On | Status |
|---------|------|------------|--------|

portfolio.md (Registry)

# Portfolio Registry
| Project-ID | Name | Status | Priority | Health | Agents | Progress | Last Updated | ROI |
|------------|------|--------|----------|--------|--------|----------|-------------|-----|
| P-001 | Alpha | ACTIVE | P1 | 85 | 3 | 65% | YYYY-MM-DD | 2.4 |

portfolio-audit.md

# Portfolio Audit — YYYY-MM-DD

## Active Projects
| Project-ID | Name | Health | Priority | Progress | Last Heartbeat | Risk Flag |
|------------|------|--------|----------|----------|----------------|-----------|

## Completed / Blocked / Recovery (per-section)

## Resource Report
- Total Agents: N | Busy: N | Idle: N (Utilization: XX%) | Blocked: N | Recovery: N

## Duplicate Work Report
| Pattern Class | Projects | Action Status |

## Top Risks
1. <risk> — <project>

## Portfolio Health: XX → <Rating>

dashboard.md

# Executive Dashboard — YYYY-MM-DD
## Portfolio Health: XX → <Rating>

## Top Projects
| Rank | Project | Health | Priority | Progress | Trend |

## Top Risks / Top Opportunities (per-section)

## Agent Utilization: <Rating> — Busy: N / Idle: N / Blocked: N / Recovery: N

## Learning Reuse
| Pattern | Reuse Count | Saved Effort |

## Quick Actions
- [ ] <action>

Replan Log Entry

### Replan #N (YYYY-MM-DD HH:mm)
- **trigger**: <R1–R8>
- **cause**: <失败原因>
- **before**: <原始 Task Tree 摘要>
- **after**: <修订后 Task Tree 摘要>
- **impact**: <影响到的 Agent Package 列表>