Session
Workflow Phases
| Phase | Actions |
|---|
| START | Load knowledge → Read skills → Create TODO → Announce |
| WORK | ◆ → Load skill → Edit → Verify → ✓ |
| END | Close ⊘ → Create log → Run scripts → Ask to push |
TODO Format
○ [agent:phase:skill] Task description [context]
| Symbol | Meaning |
|---|
| ○ | Pending |
| ◆ | In progress (only ONE active) |
| ✓ | Completed |
| ⊘ | Paused/blocked |
Examples
○ [code:WORK:backend-api] Implement auth endpoint
◆ [debugger:WORK:debugging] Fix null pointer error
✓ [documentation:WORK:documentation] Update README
⊘ [code:WORK:frontend-react] Waiting for API [deps→task1]
Session Announcement
At START, announce:
AKIS v7.4 [complexity]. Skills: [list]. Graph: [X cache hits]. [N] tasks. Ready.
END Phase Triggers
- Session duration >15 minutes
- Keywords: "done", "complete", "finished", "ready to commit"
END Phase Steps
- Close all ⊘ orphans
- Verify all edits (syntax check)
- Create workflow log:
log/workflow/YYYY-MM-DD_HHMMSS_task.md
- Run update scripts:
python .github/scripts/knowledge.py --update
python .github/scripts/skills.py --update
python .github/scripts/agents.py --update
- ASK before git push
Workflow Log Format
---
session:
id: "YYYY-MM-DD_task"
complexity: medium # simple|medium|complex
skills:
loaded: [skill1, skill2]
files:
modified:
- {path: "file.tsx", domain: frontend}
agents:
delegated:
- {name: code, task: "Task", result: success}
root_causes: # REQUIRED for debugging
- problem: "Error description"
solution: "Fix applied"
---
# Session: Task Name
## Summary
Brief description.
## Tasks
- ✓ Task 1
- ✓ Task 2
Delegation Rules
| File Count | Action |
|---|
| <3 files | Optional delegation |
| 3+ files | MANDATORY delegation |
| 6+ tasks | MANDATORY parallel pairs |
Parallel Pairs
| Pair | Pattern |
|---|
| code + docs | Parallel |
| code + tests | Parallel |
| debugger + docs | Parallel |
| research + code | Sequential |
| frontend + backend | Sequential (API contract) |
