From aedaa5d11b24c222a79038dc2dac1590be16f072 Mon Sep 17 00:00:00 2001 From: Brummel Date: Thu, 18 Jun 2026 11:59:53 +0200 Subject: [PATCH] =?UTF-8?q?chore:=20track=20docs/specs=20and=20docs/plans?= =?UTF-8?q?=20again=20=E2=80=94=20retire=20via=20git=20rm=20at=20cycle=20c?= =?UTF-8?q?lose?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Drop the gitignore entries for both dirs; align the CLAUDE.md note from "git-ignored, local-only" to "git-tracked — committed while the cycle is live, removed (git rm) at cycle close". The durable record stays the ledger + git history; specs/plans are transient in the repo, present only for their own cycle. --- .gitignore | 4 ---- CLAUDE.md | 11 ++++++----- 2 files changed, 6 insertions(+), 9 deletions(-) diff --git a/.gitignore b/.gitignore index a97baf1..2ddfa15 100644 --- a/.gitignore +++ b/.gitignore @@ -12,7 +12,3 @@ Cargo.lock.orig # `aura sweep` persists run records to ./runs/runs.jsonl by default; that store # is local run telemetry, not a repo artifact. /runs/ - -# Specs and plans are kept as local working artifacts, not checked into the repo. -/docs/specs/ -/docs/plans/ diff --git a/CLAUDE.md b/CLAUDE.md index 13ea82c..53303b0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,11 +8,12 @@ freeze a validated strategy into a standalone bot with a broker connection. This file is the project sittenkodex. It imports the universal discipline from `~/dev/skills/templates/CLAUDE.md.fragment` and adds aura's domain invariants. The full architecture lives in the design ledger (`docs/design/`), not here. -Per-cycle specs (`docs/specs/`) and plans (`docs/plans/`) are local-only, -ephemeral working artifacts — git-ignored, valid only for the cycle that -produces them. Durable rationale is lifted to the ledger; a spec/plan is never -treated as a live API reference (its code snippets drift the moment the code -moves). The canonical record of past cycles is the ledger plus the git history. +Per-cycle specs (`docs/specs/`) and plans (`docs/plans/`) are ephemeral working +artifacts, kept git-tracked — committed while their cycle is live and removed +(`git rm`) at cycle close, valid only for the cycle that produces them. Durable +rationale is lifted to the ledger; a spec/plan is never treated as a live API +reference (its code snippets drift the moment the code moves). The canonical +record of past cycles is the ledger plus the git history. ## Roles