Skip to content

docs(readme): full rewrite — 15 rings, 45 specs, 27 agents [TASK-002]#41

Merged
gHashTag merged 2 commits into
masterfrom
task/002-readme-update
Apr 4, 2026
Merged

docs(readme): full rewrite — 15 rings, 45 specs, 27 agents [TASK-002]#41
gHashTag merged 2 commits into
masterfrom
task/002-readme-update

Conversation

@gHashTag
Copy link
Copy Markdown
Owner

@gHashTag gHashTag commented Apr 4, 2026

README.md Full Rewrite

Closes #40

Changes

  • Badges: CI, open issues, open PRs, ring count, spec count, agent count, license
  • Quick Start: actual t27c CLI commands (parse, gen-zig, gen-verilog, gen-c, seal --verify)
  • Architecture tree: accurate mapping of all 45 specs across 10 spec domains + 15 compiler specs
  • SEED-RINGS table: rings 0–17 with layer, capability, status (15 sealed, 1 open, 2 planned)
  • GoldenFloat table: all 7 formats with exp/mant/φ-distance
  • Sacred constants: proper .t27 syntax
  • 27-agent system: overview table with domains and key files
  • 8 Constitutional Laws: summary table with one-line rules
  • PHI LOOP: full 9-step workflow
  • Contributing guide: LAW 4 compliant (issue → branch → spec edit → PR)
  • Documentation index: organized by governance / architecture / agents

What was wrong with old README

  • Said 'TRI-27 Assembly' — t27 is a spec-first language, not just assembly
  • Example code showed raw assembly MOV/JMP — not how t27 actually works
  • Architecture tree was incomplete (missing .trinity/, tests/, stage0/)
  • No mention of 27-agent system
  • No SEED-RINGS progress
  • No contributing guide
  • No badges
  • Said '55 PHI LOOP skills' — outdated

φ² + 1/φ² = 3 | TRINITY

NeuroCoder Agent V and others added 2 commits April 4, 2026 12:43
- Added badges (CI, issues, PRs, rings, specs, agents, license)
- Quick Start with actual t27c CLI commands
- Accurate architecture tree matching current repo
- SEED-RINGS progress table (rings 0-17)
- GoldenFloat family table with phi-distance
- Sacred constants in .t27 syntax
- 27-agent system overview table
- 8 Constitutional Laws summary
- PHI LOOP 9-step workflow
- Contributing guide (LAW 4 compliant)
- Full documentation index (governance, architecture, agents)

Closes #40
@gHashTag gHashTag merged commit d4bee98 into master Apr 4, 2026
3 checks passed
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.

[TASK-002]: Update README.md — reflect 15 sealed rings, 45 specs, 27 agents

1 participant