docs: add ai-coding-factory research, gap analysis, and grill-me scope

Add research exploration notes (principles, challenges, implementation
guidance, skills index, session log) and gap/conflict analysis against the
current repo vision and roadmap. Sharpen the roadmap housekeeping item with
the grill-me intent, central scope question, and expected output (ADR +
updated chunk scope for 2, 3, and 4).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-16 20:07:00 +00:00
parent 15a4387eb2
commit ace8b53abf
8 changed files with 2263 additions and 0 deletions

View File

@@ -88,6 +88,8 @@ Items consciously not resolved — to be addressed in the relevant chunk PRD or
## Housekeeping reminders
- **AI coding factory research** — `docs/research/ai-coding-factory/` contains exploration notes (principles, challenges, implementation guidance, skills index, session log). Gap and conflict analysis complete: `docs/notes/factory-research-gaps-conflicts.md`. Next step: `/grill-me` session with that note as input. Central question to resolve first: *what is the boundary between this global config repo and the factory pattern — which factory features belong here, which belong in project repos?* Once that's settled, the dependent decisions follow (skill taxonomy, LESSONS.md, convention placement). Output: decision record → ADR + updated chunk scope for 2, 3, and 4.
- **`.gitkeep` files** — placeholder files exist in `core/agents/`, `core/workflows/`, `core/prompts/`, `docs/ard/`, `docs/bug/`, `docs/notes/`. Remove each when the first real file is added to that directory. Each `.gitkeep` names the chunk that will populate it.
- **Skills pipeline verified** — `install.sh` deploys 12 skills to `~/.agents/skills/` and creates `~/.claude/skills/ → ~/.agents/skills/` symlink adapter. Tested idempotent. `skills-lock.json` removed (was a manual artifact). If `~/.claude/skills/` exists as a real directory on a machine being migrated, remove it manually and re-run install.
- **Chunk 2 behavioral tests** — 8 manual scenarios in `tests/test-instructions-and-docs.sh` (MANUAL TEST PLAN section) are pending verification. Must run in a fresh Claude session before Chunk 2 is fully verified. See instruction quality finding in `CONTEXT.md` for why these cannot be skipped.