diff --git a/AGENTS.md b/AGENTS.md index 2a8e7d0..bebf874 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,12 +4,8 @@ This repo is the global AI development configuration repository — the authorit ## Structure -- `.claude-plugin/` — marketplace manifest (`marketplace.json`); read by both Claude Code and Copilot CLI - `plugins/` — installable plugin units; each is self-contained (skills, agents, hooks, MCP servers, bundled assets); install separately via `claude plugin install @holocron` - `providers/claude-code/` — Claude Code adapter (deployed to `~/.claude/` via `install.sh`) -- `docs/` — project documentation, PRDs, and issues -- `scripts/` — install.sh (sync.sh and init-project.sh come in Chunk 6) -- `tests/` — test scripts ## Key documents @@ -25,12 +21,11 @@ Read these on demand: - `docs/ai-constitution.md` — full governance evidence base; read when a governance decision needs justification - `docs/research/ai-coding-factory/ai-coding-factory-principles.md` — factory design rationale; read when implementing, auditing, or reviewing skills or factory structure - `docs/notes/factory-integration-decisions.md` — decisions from the factory integration grill; read when making skill authoring or factory design decisions -- `docs/HUMANS.md` — human practitioner checklist; applies when working with AI tools in this repo -- Governance rules are always in effect — `core/instructions/governance.md` (agent rules); `docs/research/governance_principles/CONTROLS.md` (Phase 2 enforcement spec, Chunk 6) +- `docs/wiki/HUMANS.md` — human practitioner checklist; applies when working with AI tools in this repo +- Governance rules are always in effect — `core/instructions/governance.md` (agent rules); `docs/research/governance_principles/CONTROLS.md` ## Key rules -- Never edit files deployed by `sync.sh` directly in a project; put customizations in override files - `providers/claude-code/CLAUDE.md` is the deployed global config — edit it there, not here - Governance constraints from `core/instructions/governance.md` apply when building content in this repo — hard prohibitions on secrets and data, HITL requirements before irreversible actions, sycophancy resistance, and deterministic execution preference are always in effect