Story: compass generate catalogue: auto-generate index org files from tagged content
Table of Contents
This page documents a story in Sprint 21. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
Goal
Several document types in the project — memories, recipes, skills, and knowledge pages — each have a hand-maintained catalogue/index org file that lists the items in that collection. These catalogues drift out of sync as new files are added without updating the index.
Add a compass generate catalogue command (or similar) that scans a directory for
org files with a given filetag and regenerates the catalogue org file from the
current set. The command should be usable for all catalogue types without
bespoke logic per collection.
Status
| Field | Value |
|---|---|
| State | BACKLOG |
| Parent sprint | Sprint 21 |
| Now | Not yet started. |
| Waiting on | Nothing. |
| Next | Break the story into tasks. |
| Last touched | 2026-06-11 |
Acceptance
compass generate catalogue(or equivalent) regenerates the index org file for a given directory/tag without manual editing.- Covers at minimum:
doc/llm/memory/memory.org,doc/llm/skills/skills.org,doc/recipes/recipes.org, and knowledge catalogue(s). - Running the command twice produces identical output (idempotent).
- New files added under a catalogue directory appear in the index after running the command; deleted files are removed.
Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
Decisions
Out of scope
- Auto-running on commit or watch mode (can be added later).
- Generating HTML output directly (the org file is the source; the site build handles HTML publication).