Files

Defame1297 537c681bb9 docs: Chunk 3 grill, PRD, ADRs, and doc updates

- docs/prd/chunk-3-skills-library.md: PRD for 42-skill library rebuild;
  AGENTS.md refactor as prerequisite; factory bootstrap order (write-eval
  first); source field schema; upstream review cadence; design phase
  sequence; IaC/Gitea scope decisions
- docs/adr/0011-provider-agnostic-issue-tracker.md: file-based default,
  Gitea as provider adapter, "issue" as canonical cross-provider term
- docs/adr/0012-agents-md-provider-agnostic-entry-point.md: AGENTS.md as
  content source, CLAUDE.md as thin adapter; partially supersedes ADR-0005
- CONTEXT.md: 8 new glossary terms (AGENTS.md, skill composition, source
  field, provider-agnostic issue tracker, design phase sequence, PRD scope,
  issue scope, bidirectional reference principle); CLAUDE.md index model
  updated; stale workflow example fixed
- docs/ROADMAP.md: changelog tooling and IaC/Gitea scope resolved; when:
  field question updated; Chunk 3 grill housekeeping note added
- docs/spec/overview.md: Chunk 3 target updated with PRD link, skill count,
  and AGENTS.md prerequisite

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

2026-05-17 14:22:59 +00:00

3.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, diagnose, grill-me, grill-with-docs, improve-codebase-architecture, prototype, tdd, to-issues, to-prd, triage, write-a-skill, zoom-out.

Chunk 3 target: 42 skills across 9 categories. PRD: docs/prd/chunk-3-skills-library.md. Canonical build reference: docs/research/ai-coding-factory/ai-coding-factory-skills-index.md (delete once all skills exist). Skills stored flat (skill-name/SKILL.md) per ADR-0009; category in metadata.category frontmatter. Categories: design, factory, implement, test, review, deploy, operate, cross-cutting, iac (2 skills only — docker-compose + iac-security-review). Role skills (6) deferred to Chunk 5. Gitea skills moved to providers/gitea/ provider adapter.

Prerequisite: AGENTS.md refactor must complete before Chunk 3 skill implementation begins — both CLAUDE.md files (repo-level and global) become thin adapters importing AGENTS.md. See ADR-0012 (to be written during implementation).

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 — behavioral tests fully resolved: CONTEXT.md now always-loaded via @import in repo CLAUDE.md; standing rule added to check docs/adr/ and ROADMAP resolved entries before answering design questions; communication/behavior and secrets rules tightened; Chunk 2 and Governance Phase 1 ✅ complete
2026-05-17 — added LESSONS.md (issue 0013) and docs/spec/ (issue 0014); refactored docs/VISION.md to goals/intent only

3.0 KiB Raw Blame History