16 lines
1.7 KiB
Markdown
16 lines
1.7 KiB
Markdown
# Reflection Index
|
|
|
|
Use this index for second-order workflow lessons.
|
|
|
|
| Date | Reflection | Trigger | Action | Detail |
|
|
|---|---|---|---|---|
|
|
| 2026-08-28 | Shared rolling planning files created repeated size pressure and forced semantic compression. | Root `task_plan.md` repeatedly approached or exceeded its fixed limit. | Replaced the legacy system with task-scoped records plus serialized canonical integration in `.project-docs/`. | [Migration task](../30-worklog/tasks/20260828-migrate-project-docs-6f1a9c2d.md) |
|
|
| 2026-09-01 | A leadership dashboard is not a task audit log. | Human correction after an audit/history-oriented first implementation. | Start with audience and decision questions; keep leadership aggregates and business drill-through separate from engineering diagnostics. | [Reflection](cases/20260901-leadership-dashboard-c4b9e1__leadership-dashboard-boundary.md) |
|
|
| 2026-09-07 | A single-Feature Integration baseline must already contain the source task record. | An Integration worktree started from the older default branch introduced the Feature record after its recorded base, so the drift gate rejected it as a foreign task-owned change. | Restart from the completed Feature commit, verify default-branch ancestry, and document the baseline rule in the Integration Gate. | [Reflection](cases/20260907-integrate-leader-summaries-84c1d7ea__integration-source-baseline.md) |
|
|
|
|
## When To Reflect
|
|
|
|
Create a reflection only when work reveals a reusable lesson: skipped gates, repeated mistakes, durable debugging patterns, ineffective plans, human corrections, or candidates for new scripts or skills.
|
|
|
|
Routine task completion belongs in `30-worklog/task-history.md`.
|