Files

Defame1297 b55eede1ef docs: implement issues 0013 and 0014 — LESSONS.md and docs/spec/

Add LESSONS.md as the long-loop feedback log at repo root. Patterns
observed during development graduate to standing rules when three or
more entries appear.

Introduce docs/spec/ as the living spec layer: overview.md (deployed
state) and architecture.md (directory structure, install pipeline,
provider model, governance layer). Refactor docs/VISION.md to goals
and intent only — architecture content moved to docs/spec/architecture.md.

Update CLAUDE.md and CONTEXT.md to reference the new spec files.
Close issues 0013 and 0014. Update ROADMAP and factory integration
note to reflect completion.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-17 10:36:59 +00:00

2.0 KiB

Raw Blame History

Overview

Current deployed state of this repo — what you get if you run install.sh today. Updated at the close of each chunk and in the same PR as any behavior change.

Last updated: 2026-05-17

What is deployed

Skills

12 skills deployed to ~/.agents/skills/ via install.sh. Available as slash commands in Claude Code via ~/.claude/skills/ → ~/.agents/skills/ symlink. All 12 are first-draft placeholders pending rebuild in Chunk 3.

Current skills: caveman, claude-api, diagnose, grill-me, grill-with-docs, improve-codebase-architecture, init, prototype, review, security-review, tdd, to-issues, to-prd, triage, update-config, write-a-skill.

Claude Code configuration

~/.claude/CLAUDE.md — global config index; always-on rules + content index pointers
~/.claude/core/instructions/ — coding, git, testing, governance instruction files
~/.claude/settings.json — Claude Code settings

Governance layer

core/instructions/governance.md loads into every Claude Code session via @import in ~/.claude/CLAUDE.md. Covers: hard prohibitions on secrets and data, data classification tiers, HITL requirements, sycophancy resistance, deterministic execution preference.

What works end-to-end

install.sh runs idempotently — safe to re-run after changes
Provider adapter pattern: providers/*/provider-manifest.sh auto-discovered by install.sh
Governance rules take effect at session start without any manual loading step
Skills available as slash commands immediately after install

What is not yet deployed

sync.sh — pulls updates into existing projects (Chunk 6)
init-project.sh — bootstraps a new project (Chunk 6)
Copilot provider adapter (Chunk 7)
Formal CI/pre-commit enforcement of governance rules (Chunk 6)

For chunk planning and open questions, see docs/ROADMAP.md.

Recent changes

2026-05-17 — added LESSONS.md (issue 0013) and docs/spec/ (issue 0014); refactored docs/VISION.md to goals/intent only

2.0 KiB Raw Blame History