docs: clarify Chunk 3 skill library source and naming convention

Skills-index is now explicitly the canonical build reference for trigger
descriptions, constraints, and categories. Roadmap entry updated with
category breakdown, flat-path naming reconciliation (ADR-0009), authoring
standard reference, and delete-when-done instruction. Spec overview updated
to match.

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

docs/ROADMAP.md

@@ -33,7 +33,7 @@ A parallel workstream (not a numbered chunk) that runs alongside the chunk seque
 |---|---|---|
 | ✅ 1 | Repo skeleton + `install.sh` — structure in place, Claude Code wired up | Nothing else can be built without the structure and install working |
 | ✅ 2 | Core instructions — `coding.md`, `git.md` (incl. conventional commits), `testing.md`; communication rules in `providers/claude-code/CLAUDE.md` always-on section; retire `global.md`; migrate `docs/` to subdirectory-by-type naming | Instructions are the foundation everything else references; commit convention and doc naming must be in place before history accumulates |
-| ⏳ 3 | Skills library rebuild — all 12 existing skills are first-draft placeholders; Chunk 3 rebuilds each from scratch following the full SKILL.md authoring standard (version field, category metadata, constraints section, self-check, failure handling, trigger-test-first discipline). Process per skill: check `docs/research/ai-coding-factory/ai-coding-factory-implementation-guidance.md` Section 4–5 (framework sourcing) and `docs/research/ai-coding-factory/ai-coding-factory-skills-index.md` (pre-researched trigger descriptions and constraints for 34 target skills) → research/inspect open-source implementations → grill design → implement. New skills: session-handoff (cross-cutting), governance-check (cross-cutting), git-guardrails (cross-cutting), write-adr (factory). IaC skills (global optional, iac category) and Gitea skills (global optional, gitea category) — scope defined in Chunk 3 PRD. **Infrastructure complete**: 12 skills deployed to `~/.agents/skills/` via `install.sh`; provider adapter pattern in place; all existing skills treated as drafts pending rebuild | Skills are the most immediately useful output; the rebuild is necessary because existing skills predate the authoring standard and the factory research |
+| ⏳ 3 | Skills library rebuild — the 12 existing skills are first-draft placeholders that predate the factory research; all are rebuilt or replaced. **Target library:** `docs/research/ai-coding-factory/ai-coding-factory-skills-index.md` is the canonical build reference — use it directly for each skill's trigger description, constraints, and category. Core categories: roles (6), design (3), factory (7 meta-skills — entirely new, high priority), implement (4 incl. tdd multi-file), test (3), review (4), deploy (4), operate (4), cross-cutting (4). Global optional: IaC (7) and Gitea (3) — scope defined in Chunk 3 PRD. **Naming convention:** the skills-index uses `category/skill-name` notation (e.g., `design/grill-me`) for identification only; actual paths are flat per ADR-0009 (`grill-me/SKILL.md`), category expressed in SKILL.md frontmatter. **Authoring standard:** frontmatter (`name`, `description`, `version`, `updated`, `metadata.category`), role, when/when-not, required inputs, constraints, process, output format, failure handling — per `ai-coding-factory-implementation-guidance.md` Section 10. **Process per skill:** check skills-index for trigger description and constraints → check implementation guidance Section 4–5 for framework sourcing → research/inspect open-source implementations → implement. Delete `ai-coding-factory-skills-index.md` when all skills exist. **Infrastructure complete**: 12 skills deployed to `~/.agents/skills/` via `install.sh`; provider adapter pattern in place. | Skills are the most immediately useful output; the rebuild is necessary because existing skills predate the authoring standard and the factory research |
 | 4 | Workflows — formalize the workstream workflow (kick-off types → grill → artifact → issues → implement → QA → commit); feature, bug, architecture, improvement, feedback patterns. **Prerequisite:** WorkflowContext schema (what each skill in a chain receives and returns) must be designed before any workflow skill is written; `docs/spec/` must exist (implement-feature constraint: update spec in same PR as behavior change) | Higher-level patterns built on top of a working skills foundation; grill feedback intake design before starting |
 | 5 | Agents — role skills (Architect, Developer, Reviewer, Security, QA, Ops) in `.agents/skills/` with `category: roles`; `core/agents/` for provider-agnostic subagent definitions needing isolated execution context (`context: fork`), translated to `.claude/agents/` by adapter; cross-project orchestration agents as use case | Role skills benefit from workflow patterns being established first; subagent definitions require the skills library to be stable |
 | 6 | Sync + project init tooling — `sync.sh` and `init-project.sh` | Tooling only makes sense once there is content worth syncing and scaffolding |

docs/spec/overview.md

@@ -11,6 +11,8 @@ Current deployed state of this repo — what you get if you run `install.sh` tod
 
 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:** the full skill library defined in `docs/research/ai-coding-factory/ai-coding-factory-skills-index.md`. That file is the canonical build reference — trigger descriptions, constraints, and category for each skill. Skills are stored flat (`skill-name/SKILL.md`) per ADR-0009; the `category/skill-name` notation in the skills-index is for identification only. Core categories: roles, design, factory, implement, test, review, deploy, operate, cross-cutting. Global optional: iac, gitea. Delete the skills-index once all skills exist.
+
 ### Claude Code configuration
 - `~/.claude/CLAUDE.md` — global config index; always-on rules + content index pointers
 - `~/.claude/core/instructions/` — coding, git, testing, governance instruction files