| name | session-discipline |
| description | Enforce session-first workflow (plan → implement → verify → document). Use whenever starting non-trivial work, debugging >15 minutes, or doing cross-cutting changes. |
Session Discipline
Scope
- Ensure every non-trivial task has a session folder under
docs/sessions/ - Keep evidence (commands/tests) and outcomes discoverable
- Reduce “handover friction” by making every action resumable from docs
Inputs
- Desired session slug (short, descriptive)
- Session type/category and objective one-liner
Procedure
- Create a session directory with the official CLI.
- Fill in
PLAN.md(objective, done-when, change set, risks, tests). - Log commands + findings in
WORKING_NOTES.md. - Summarize outcomes + follow-ups with named owners.
Validation
- Confirm session appears in
docs/sessions/SESSIONS_HUB.md. - Ensure
FOLLOW_UPS.mdhas owners if anything is deferred.
Escalation / Research request
If you need deeper background and existing docs aren’t sufficient:
- Add a follow-up: “Request research agent to expand Skill
” - Include: expected triggers, target files, and what validation should exist
References
- Session-first requirement:
AGENTS.md - docs-memory lessons:
docs/agi/LESSONS.md