Plan: Create CLAUDE.md for agent-core-artefacts#
Summary#
Create a CLAUDE.md at the repo root that describes agent-core-artefacts as a document/artefact storage repository (not a service), its directory structure, naming conventions, and branch/PR rules. No build system exists — this must be explicitly stated.
Files#
| File | Action | Description |
|---|---|---|
CLAUDE.md | create | Root-level agent context file describing repo purpose, structure, and conventions |
Steps#
- Create
CLAUDE.mdat the repo root with the following sections:- What this repo is — document storage for AgentSDE pipeline artefacts (architecture docs, ARDs, RFCs, planning docs, test cases, per-issue task files). Not a service, no runtime.
- Directory structure — describe
docs/(subdirs:arch/,ard/,rfc/,planning/,test-cases/,testing/) andtasks/(subdirs:production/AgentSDE/<repo>/gh-<N>/,e2e/AgentSDE/<repo>/gh-<N>/). Each task directory containsplan/,meta/, and optionallyinput/,changes/subdirectories. - Naming conventions — task dirs follow
gh-<issue-number>pattern, grouped by environment (production/e2e) and org/repo. - Dev workflow — explicitly state no
package.json, no Makefile, no build/test/lint commands. - Branch & PR rules —
feat/<issue-number>-<slug>orfix/<issue-number>-<slug>, PR body must includeCloses #<N>, never commit directly tomaster.
- Verify
CLAUDE.mdcontains no stale references toagent-corecommands or environment variables that don't apply.
Verification#
CLAUDE.mdexists at repo root and is well-formed Markdown- All documented directories match actual repo structure
- No references to build/test/lint commands that don't exist
Risks#
- Directory structure may evolve as new artefact types are added — the file should note this is a living document