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:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user