Skip to content

refactor(ai): 🏗️ drop prescribed spine from prompt injections#70

Open
justapithecus wants to merge 1 commit intomainfrom
andrew/refactor/ai/drop-spine
Open

refactor(ai): 🏗️ drop prescribed spine from prompt injections#70
justapithecus wants to merge 1 commit intomainfrom
andrew/refactor/ai/drop-spine

Conversation

@justapithecus
Copy link
Copy Markdown
Owner

Summary

Move the global AI constitution and entrypoint scripts from prescribing a fixed directory layout (docs/ARCH_INDEX.md, docs/CONTRACT_*.md, docs/contracts/) to describing source kinds (orientation, contracts, explanatory). Each repo now declares its own spine via AGENTS.md and the repo-local CLAUDE.md; the global layer no longer assumes a layout.

Highlights

  • ai/CLAUDE.md — rewrite §4 Repository Orientation, §5 Authority Convention, and §7 Structural conflict resolution to describe source kinds rather than paths.
  • Entrypoints (ai-chat, ai-plan, ai-implement, ai-review, ai-skill) — drop the ARCH_INDEX.md probe blocks. AGENTS.md injection stays.
  • ai-migrate — remove Phase B (ARCH_INDEX hardening); renumber remaining phases to A–E (Scan, CLAUDE.md, Scaffolds, Baselines, Validate). ai-help and the docs follow.
  • ai/roles/planner.md — loosen documentation scope from docs/* to "any documentation source the repository declares."
  • Migration templates — strip the prescribed docs/ARCH_INDEX.md role from templates/migration/CLAUDE.md and the convention-enforcer skill template; both now ask the repo to declare its own orientation source.
  • DocsMIGRATION.md, README.md, docs/workflows.md updated to the five-phase flow and path-agnostic wording.

Test plan

  • ai-chat, ai-plan, ai-implement, ai-review, ai-skill build their system prompts cleanly without an ARCH_INDEX.md in the repo
  • ai-migrate runs end-to-end on a fresh repo and reports phases A–E
  • ai-help migrate shows the new five-phase block
  • bash -n clean on all modified scripts (verified locally)

🤖 Generated with Claude Code

Move the global constitution and entrypoint scripts from prescribing a
fixed directory layout (`docs/ARCH_INDEX.md`, `docs/contracts/`, etc.)
to describing source kinds (orientation, contracts, explanatory). Each
repo now declares its own spine via AGENTS.md and repo-local CLAUDE.md.

- rewrite ai/CLAUDE.md §4/§5/§7 to describe source kinds, not paths
- remove ARCH_INDEX probes from ai-chat/plan/implement/review/skill
- strip Phase B (ARCH_INDEX hardening) from ai-migrate; renumber to A–E
- loosen planner role's documentation scope
- update MIGRATION.md / README.md / workflows.md / migration templates
  to match the new five-phase flow and path-agnostic model

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant