Skip to content

chore: bootstrap mono-repo + source-of-truth docs (EPIC-0) - #1

Merged
evidence-codes merged 1 commit into
mainfrom
epic-0/mono-repo-bootstrap
May 29, 2026
Merged

chore: bootstrap mono-repo + source-of-truth docs (EPIC-0)#1
evidence-codes merged 1 commit into
mainfrom
epic-0/mono-repo-bootstrap

Conversation

@evidence-codes

Copy link
Copy Markdown
Owner

EPIC-0 — Mono-repo bootstrap & foundations

Establishes the source-of-truth doc set, the Make orchestration model, and the full mono-repo scaffold. All EPIC-0 sub-tasks (0.1–0.8) are owner-verified (✅).

Docs (source of truth)

  • README, FEATURE_STATUS, GAP_ANALYSIS, TASKS, CLAUDE.md, CONTRIBUTING, docs/DEVELOPMENT
  • ADR-0001: Make as the coarse cross-ecosystem orchestration graph

Scaffold

  • Layout: apps/, packages/, server/, models/, plugins/, tools/
  • Root Makefile owns the coarse graph + cross-tool stamps (.make/), delegating each verb to thin per-module Makefiles (recursive Make)
  • packages/contracts skeleton (OpenAPI + sync-protocol) — the version-locked spine

Tooling

  • .editorconfig, ruff.toml, .swiftformat, pre-commit, .gitignore
  • CI: per-ecosystem jobs (Python/Kotlin/Swift) driving the Make surface

🤖 Generated with Claude Code

Source-of-truth doc set (read before any work):
- README, FEATURE_STATUS, GAP_ANALYSIS, TASKS, CLAUDE.md
- ADR-0001: Make as the coarse cross-ecosystem orchestration graph;
  native tools (Gradle/Xcode-SPM/Python) own file-level incrementality

Mono-repo scaffold:
- Layout: apps/, packages/, server/, models/, plugins/, tools/
- Root Makefile owns the coarse graph + cross-tool stamps (.make/),
  delegating each verb to thin per-module Makefiles (recursive Make)
- packages/contracts skeleton (OpenAPI + sync-protocol) as the
  version-locked spine

Tooling & process:
- .editorconfig, ruff.toml, .swiftformat, pre-commit, .gitignore
- CI: per-ecosystem jobs (Python/Kotlin/Swift) driving the Make surface
- CONTRIBUTING.md + docs/DEVELOPMENT.md

All EPIC-0 sub-tasks (0.1-0.8) owner-verified.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@evidence-codes
evidence-codes merged commit c1fd671 into main May 29, 2026
7 of 13 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