ed/manual_slop
Private
Public Access
0
0
Fork 0
Code Activity

conductor(track): document 3-step archiving convention in tracks.md (FR3)

Browse Source
This commit is contained in:
Edward R. Gonzalez
2026-06-20 16:19:31 -04:00
parent b9f0129555
commit b697cd8835
1 changed files with 7 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
conductor/tracks.md
+7
View File
@@ -790,3 +790,10 @@ Tracks that produce a research deliverable (a markdown report) rather than Appli
**Naming convention:** Each track's `spec.md` and `plan.md` (where present) follow the project's standard format: `spec.md` for design intent (the "why"), `plan.md` for executable tasks (the "how"). See `conductor/tracks/data_oriented_error_handling_20260606/` for the canonical example.
**Editing this file:** When you mark a track as `[x]` and move its folder to `archive/`, also move it to the appropriate Archived sub-section. When you start a new track, create the folder under `tracks/` first, then add the entry to the Active Tracks table at the top. The git-blame sort order (`0a`, `0b`, `0c`...) is no longer used; this file is now organized by phase + dependency.
**Archiving a track (3 steps):** When a track ships and its folder moves from `conductor/tracks/<id>/` to `conductor/archive/<id>/`, complete all 3 steps in order:
1. Move the folder: `git mv conductor/tracks/<id> conductor/archive/<id>` (preserves history as a rename).
2. Remove the `[x]` entry from this file (`conductor/tracks.md`). Update any related status badges (e.g., dependency links in the Active Tracks table or other sections).
3. Add a row to [`conductor/chronology.md`](./chronology.md) with the init SHA (first commit on the track's folder), the end SHA (the archive-move commit), the date, the track ID, the status, and a one-sentence summary. Chronology.md is the canonical index of all tracks (active, shipped, superseded, abandoned); this file is the active task list.
The 3-step convention is documented here because this is where the existing "Editing this file" section already lives. The spec/plan referenced `conductor/workflow.md` "Notes > Editing this file" but that section doesn't exist; the actual location is `conductor/tracks.md`.