feat(doctrine): TODO seeds carry ## Actionable; session start trusts the digest

This commit is contained in:
bchanot committed 2026-11-12 21:55:31 +01:00
1 parent 1124758a8b
commit 63bea87803
4 files changed
+14 -11

No files matched your search

+7 -7
View File
@@ -50,14 +50,14 @@ code" wins. Repo-specific instructions override both.
Hacky fix → rebuild clean, no over-engineering.
## Session start
1. Read `.claude/tasks/TODO.md`. The banner's `memory digest` lists open
blockers and the last journal line: apply both before touching
anything; a `+N` line → read those entries in `blockers.md`. No
digest (foreign repo, memory mod off) → list the open blockers
yourself.
1. The banner's `memory digest` lists open blockers, the first unchecked TODO
items (`## Actionable`, else the file's first) and the last journal line:
apply them before touching anything; a `- open: +N` line → read those
entries in `blockers.md`. No digest (foreign repo, memory mod off) → read
`.claude/tasks/TODO.md` and list the open blockers yourself.
2. Read a registry (`.claude/memory/`: decisions, learnings, blockers,
journal, evals) when the task needs it; planning flows scan them per
`~/.claude/lib/analyze-before-plan.md`.
journal, evals) or `.claude/tasks/TODO.md` when the task needs it;
planning flows scan them per `~/.claude/lib/analyze-before-plan.md`.
3. Either missing → create it first (templates: `~/.claude/templates/memory/`).
## Workflow
+2 -2
View File
@@ -80,7 +80,7 @@ ls .claude/tasks/TODO.md 2>/dev/null
reconcile volet (STEP 2B) on it:
```bash
mkdir -p .claude/tasks
printf '# TODO\n\n## %s\n' "$(date +%Y-%m-%d)" > .claude/tasks/TODO.md
[ -f .claude/tasks/TODO.md ] || printf '# TODO\n\n## Actionable\n<!-- next items; the session digest shows the first 3 unchecked (else the first 3 of the file) -->\n\n## %s\n' "$(date +%Y-%m-%d)" > .claude/tasks/TODO.md
```
## STEP 1 — SCAN THE CONVERSATION
@@ -372,7 +372,7 @@ CAPITALIZE COMPLETE — <YYYY-MM-DD> (<pre-wipe flush | session-close>)
Then the closing line — pick by the STEP 5C persist result (`<mode>` = `Context
flushed` for pre-wipe, `Session closed` for ritual):
- **auto-persisted (push mode `auto`, finish rc 0 AND `ahead` = 0)** → `✅ <mode> + persisted to origin/develop (<short>). Next session: TODO.md and the startup digest (open blockers, last journal line).`
- **auto-persisted (push mode `auto`, finish rc 0 AND `ahead` = 0)** → `✅ <mode> + persisted to origin/develop (<short>). Next session: the startup digest (open blockers, actionable TODO, last journal line).`
On the `--no-push` path ONLY read TWO facts first, each its own Bash call: `bash "$HOME/.claude/lib/gitflow.sh" push-mode` and `git rev-list --count origin/chore/<name>..chore/<name> 2>/dev/null || echo unknown` (`branch_ahead`). `<push mode>` below is the verb's word. The WORKING-branch and rc 3 paths have no `chore/<name>` and never use the mode.
+1 -1
View File
@@ -115,7 +115,7 @@ it (doctrine: registries + TODO exist from day one; STEP 10b appends to them):
```bash
mkdir -p .claude/memory .claude/tasks
cp -n ~/.claude/templates/memory/{decisions,learnings,blockers,evals,journal}.md .claude/memory/
[ -f .claude/tasks/TODO.md ] || printf '# TODO\n\n## %s\n' "$(date +%Y-%m-%d)" > .claude/tasks/TODO.md
[ -f .claude/tasks/TODO.md ] || printf '# TODO\n\n## Actionable\n<!-- next items; the session digest shows the first 3 unchecked (else the first 3 of the file) -->\n\n## %s\n' "$(date +%Y-%m-%d)" > .claude/tasks/TODO.md
```
Verify: `git init` + build passes.
+4 -1
View File
@@ -989,6 +989,9 @@ Format :
```
# TODO — onboard backlog (<date>)
## Actionable
<!-- next items; the session digest shows the first 3 unchecked (else the first 3 of the file) -->
<!-- Généré par /onboard — une entrée par proposition approuvée.
Format: - [ ] [Priorité] [/skill] — description — fichiers estimés -->
@@ -1028,7 +1031,7 @@ Format :
| Audit SEO/GEO à re-lancer après corrections | `/seo` ou `/geo` |
| Audit docs à re-sync après changement | `/doc` |
Ne PAS écraser `.claude/tasks/TODO.md` s'il contient déjà du contenu utilisateur : append avec un séparateur :
Sans contenu utilisateur (le stub de l'onboarder compte pour aucun) : écrire le format complet, bloc `## Actionable` inclus. Avec contenu utilisateur : ne PAS écraser, append avec un séparateur et SANS second `## Actionable` :
```
<contenu existant>