b5a57cbf18
docs: add docs/validation/ — in-repo home for the agentic validation system
...
Single-file README at docs/validation/README.md covering all three
regression layers (behavioral smoke, cryptographic witness, temporal
history) with cross-references to ADR-102, ADR-103, the witness
manifest, the toolkit scripts, and the CI workflow.
Includes the four CI Integration Pitfalls discovered during the
2026-05-08 work — pnpm isolated linker, CLI dogfood gotcha,
workspace:* protocol, silent set -e exits — with concrete YAML/JS
fixes for each.
The public gist at gist.github.com/ruvnet/ee7763c36f7a9a1c1886da783abc872b
remains the external-friendly version (no ruflo-specific paths);
this doc is the authoritative in-repo source.
Linked from docs/index.md under "Trust & Security".
Co-Authored-By: RuFlo <ruv@ruv.net >
2026-05-09 00:03:43 -04:00
1b6a1971f7
feat(v3): add comprehensive v3 implementation plans and swarm architecture
...
- Reorganize v3/ into implementation/ subfolders:
- planning/, architecture/, migration/, integration/
- security/, adrs/, research/, swarm-plans/
- Add 15-agent concurrent swarm implementation plans:
- SWARM-OVERVIEW.md: Hierarchical mesh topology, 4 phases
- AGENT-SPECIFICATIONS.md: 15 agent configs with capabilities
- TDD-LONDON-SCHOOL-PLAN.md: Mock-first TDD methodology
- BENCHMARK-OPTIMIZATION.md: Performance targets (2.49x-7.47x)
- DEPLOYMENT-PLAN.md: Release strategy, CI/CD, rollback
- GITHUB-ISSUE-TRACKING.md: Issue workflow with agent replies
- Update .claude/settings.json with proper hooks format
- Add bash aliases for claude --dangerously-skip-permissions
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-01-04 15:40:51 +00:00
27e1bc1c99
docs: Reorganize documentation structure for better navigation
...
SCOPE: Documentation organization and navigation improvements
CHANGES:
- Reorganized 19 markdown files into logical subdirectories
- Created 7 category-specific README.md index files
- Updated main docs/README.md with new organized structure
- Updated root README.md documentation section
- Updated docs/INDEX.md with complete navigation tree
- Fixed API key reference in release notes
NEW STRUCTURE:
📁 docs/
├── 🚀 releases/ - Release notes by version (v2.7.1, alpha releases)
├── 🧠 agentdb/ - AgentDB v1.3.9 integration docs (7 files)
├── ⚡ performance/ - Performance optimization guides (2 files)
├── 🔧 fixes/ - Bug fix documentation (3 files)
├── 🛠️ development/ - Development reports (3 files)
├── ✅ validation/ - Test reports and validation (1 file)
└── 📚 guides/ - User guides and tutorials (1 file)
BENEFITS:
✅ Clear categorization by purpose (releases, performance, fixes, etc.)
✅ Easy navigation with category-specific README files
✅ Version-organized release notes (v2.7.1, v2.7.0-alpha.10, etc.)
✅ Preserved git history using 'git mv'
✅ All internal links updated and verified
✅ Clean docs root with only 2 files (README.md, INDEX.md)
FILES MOVED: 19 total
- 5 release files → docs/releases/
- 4 AgentDB files → docs/agentdb/
- 3 development files → docs/development/
- 2 performance files → docs/performance/
- 3 fix files → docs/fixes/
- 1 validation file → docs/validation/
- 1 guide file → docs/guides/
NEW FILES: 7 README.md index files
- docs/releases/README.md
- docs/agentdb/README.md
- docs/performance/README.md
- docs/fixes/README.md
- docs/development/README.md
- docs/validation/README.md
- docs/guides/README.md
PART OF: feature/agentdb-integration (documentation cleanup)
🔥 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-10-23 14:40:43 +00:00
Reuven