Skip to content

docs: overhaul project documentation for open-source readiness#36

Merged
aGallea merged 1 commit into
masterfrom
docs/documentation-overhaul
Apr 6, 2026
Merged

docs: overhaul project documentation for open-source readiness#36
aGallea merged 1 commit into
masterfrom
docs/documentation-overhaul

Conversation

@aGallea

@aGallea aGallea commented Apr 6, 2026

Copy link
Copy Markdown
Owner

Summary

  • Refined README.md — added badges (CI, license), tech stack table, cleaner structure, links to new docs
  • Fixed coverage threshold inconsistency across AGENTS.md and CLAUDE.md (90%, not 70%, matching CI)
  • Updated AGENTS.md — project structure now reflects server routes, ai_naming, annotations, frontend
  • Created docs/ARCHITECTURE.md — system design, data flow diagrams, component breakdown, design decisions
  • Created docs/USAGE.md — all three modes, full env var reference, complete API endpoint listing
  • Created CONTRIBUTING.md — dev setup, testing, code style, commit conventions, PR process
  • Created CODE_OF_CONDUCT.md — Contributor Covenant v2.1
  • Created SECURITY.md — vulnerability reporting, scope, security considerations
  • Created CLAUDE.md — Claude Code guidance for this repository
  • Configured branch protection — added required CI status checks (lint, typecheck, test) with strict mode

Test plan

  • Verify all markdown links resolve correctly
  • Verify badges render on GitHub
  • Confirm branch protection shows lint/typecheck/test as required checks
  • Review docs for accuracy against current codebase

🤖 Generated with Claude Code

- Refine README.md: add badges, tech stack table, cleaner structure,
  link to new docs
- Fix coverage threshold inconsistency (90% not 70%) in AGENTS.md
  and CLAUDE.md
- Update AGENTS.md project structure to reflect server routes,
  ai_naming, annotations, and frontend
- Create docs/ARCHITECTURE.md: system design, data flow diagrams,
  component breakdown, design decisions
- Create docs/USAGE.md: all three modes, env var reference, full
  API endpoint listing
- Create CONTRIBUTING.md: setup, testing, code style, PR process
- Create CODE_OF_CONDUCT.md: Contributor Covenant v2.1 reference
- Create SECURITY.md: vulnerability reporting, scope, considerations
- Create CLAUDE.md: Claude Code guidance for this repository

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions

github-actions Bot commented Apr 6, 2026

Copy link
Copy Markdown

Tests Report 📄

Tests Succees ✅

JUnit Details

Total Tests Failures Errors Skipped Time ⏳
281 0 0 0 69.34s

Coverage Details ☑️

No coverage details to present

@aGallea aGallea merged commit d43492c into master Apr 6, 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.

1 participant