# 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