tractatus/docs/architecture
TheFlow f7fecbf1a8 docs(architecture): add ADR-001 for public repository release process
DECISION:
Maintain separate internal (tractatus) and public (tractatus-framework)
repositories with distinct purposes and content.

RATIONALE:
- Security: Internal research and strategy must not be public
- Clarity: Developers need implementation docs, not governance theory
- Professionalism: Public repo must appear world-class
- Prevent Misuse: "Bad actor bias" incident showed AI misrepresentation risk

PROCESS DOCUMENTED:
- 8-phase cleanup (615 → 96 files, 84% reduction)
- Professional documentation suite (CHANGELOG, SECURITY, README badges)
- GitHub Release v3.5.0 with downloadable packages
- Community features (Discussions enabled)

GOVERNANCE RULE CREATED:
- inst_063_CONSOLIDATED: Public GitHub Management
  - Prohibits: Governance research, deliberation guides, theoretical frameworks
  - Allows: Technical docs, API guides, code examples
  - Requires: Weekly README review

BAD ACTOR BIAS INCIDENT:
AI suggested converting implementation docs to "governance guide for preventing
bad actors" - exact opposite of framework's pluralistic deliberation purpose.
inst_063_CONSOLIDATED now prevents this misrepresentation.

METRICS:
- Repository reduction: 84% fewer files
- README growth: +73% (215 → 372 lines)
- Documentation quality: Publication-ready
- Community ready: Discussions enabled, professional appearance

File: docs/architecture/ADR-001-public-repository-release-process.md (610 lines)

🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 00:30:54 +13:00
..
ADR-001-public-repository-release-process.md docs(architecture): add ADR-001 for public repository release process 2025-10-22 00:30:54 +13:00