Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 19 additions & 8 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,14 +69,25 @@ see Known Gaps 3 before quoting a green suite.

## Machine-Readable Artefacts

Files in `.machine_readable/` contain structured project metadata:

- `.machine_readable/descriptiles/STATE.a2ml` - Current project state and progress
- `.machine_readable/descriptiles/META.a2ml` - Architecture decisions and development practices
- `.machine_readable/descriptiles/ECOSYSTEM.a2ml` - Position in the ecosystem and related projects
- `.machine_readable/descriptiles/AGENTIC.a2ml` - AI agent interaction patterns
- `.machine_readable/descriptiles/NEUROSYM.a2ml` - Neurosymbolic integration config
- `.machine_readable/descriptiles/PLAYBOOK.a2ml` - Operational runbook
A2ML is retired (standards rulings D99, D269c, D312, D313). Hypatia was migrated off it on
2026-11-14: never create, restore or extend a `.a2ml` file here. Repository facts are deed
clauses (grammar: standards `1-formats/deed/spec/abnf/deed.abnf`; lint with
`bun <standards>/1-formats/deed/tools/deed_lint.js FILE.deed`):

- `0-AI-MANIFEST.deed` - the machine front door, pointer-only
- `hypatia_chora.deed` - the repo deed: `(identity)` `(clade)` `(forges)` `(lineage)` `(status)`
(lifecycle), `(maturity)`, `(meta)` (ADRs), `(ecosystem)`, `(agentic)` (agent permissions and
integrity axioms), `(neurosym)` (scan config), `(playbook)`, `(anchor)` (semantic authority),
`(egress)` (ADR-009)
- `hypatia_rules_praxis.deed` - the A5 rule registry, generated by `scripts/gen-rules-praxis.sh`
- `docs/history/A2ML-REMOVED.adoc` - each removed `.a2ml` file, its git blob id, and where its
content went

Two `.a2ml` files remain, each for a reader outside this repo (see the ledger):
`audits/assail-classifications.a2ml` (panic-attack reads only that name) and
`test/fixtures/a2ml/rsr-criteria-v2.a2ml` (a copy of the standards RSR criteria, still A2ML).
The rules that *detect* `.a2ml` in scanned repos, and the shared readers that fall back to it
(`RsrConformance`, `RsrCriteria`, `RuleLoader`), are deliberate.

## Safety Triangle Pipeline (OPERATIONAL)

Expand Down
5 changes: 3 additions & 2 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,9 @@ We welcome contributions in many forms:

## Getting Started

1. **Read the AI Manifest:** Start with `0-AI-MANIFEST.a2ml` (if
present) to understand the repository structure.
1. **Read the AI Manifest:** Start with `0-AI-MANIFEST.deed`, the
pointer-only front door, then `hypatia_chora.deed` for the
repository facts.

2. **Environment:** Use `guix` `shell` `-D` `-f` `guix.scm` (or
`direnv` `allow`) to set up your tools. Guix is the canonical
Expand Down
52 changes: 0 additions & 52 deletions .machine_readable/CLADE.a2ml

This file was deleted.

2 changes: 1 addition & 1 deletion .machine_readable/MUST.contractile
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@

; Structure
(must ".machine_readable/ directory preserved")
(must "0-AI-MANIFEST.a2ml preserved")
(must "0-AI-MANIFEST.deed preserved")
(must "no SCM files in repo root — only in .machine_readable/")

; CI
Expand Down
23 changes: 0 additions & 23 deletions .machine_readable/anchors/ANCHOR.a2ml

This file was deleted.

41 changes: 0 additions & 41 deletions .machine_readable/bot_directives/README.adoc

This file was deleted.

63 changes: 0 additions & 63 deletions .machine_readable/bot_directives/coverage.a2ml

This file was deleted.

51 changes: 0 additions & 51 deletions .machine_readable/bot_directives/debt.a2ml

This file was deleted.

109 changes: 0 additions & 109 deletions .machine_readable/bot_directives/methodology.a2ml

This file was deleted.

Loading
Loading