Add contributor docs, Alex brief, and evaluate-trigger #48

Merged

m3taversal merged 22 commits from leo/architecture-as-claims into main

2026-03-07 16:46:54 +00:00

m3taversal commented

2026-03-07 16:23:06 +00:00

(Migrated from github.com)

Summary

CONTRIBUTING.md — step-by-step guide for external contributors to submit source material
docs/ALEX_BRIEF.md — onboarding brief for Alex covering the AI alignment domain, contribution modes, claim schema, and what we proved this week
ops/evaluate-trigger.sh — headless Leo evaluation trigger script (reviewed by Ganymede, all fixes applied)

Context

Full autonomous pipeline proved today (PR #47): Crawl4AI → headless Theseus extraction → headless Leo evaluation. These docs make the system multiplayer-ready.

## Summary - **CONTRIBUTING.md** — step-by-step guide for external contributors to submit source material - **docs/ALEX_BRIEF.md** — onboarding brief for Alex covering the AI alignment domain, contribution modes, claim schema, and what we proved this week - **ops/evaluate-trigger.sh** — headless Leo evaluation trigger script (reviewed by Ganymede, all fixes applied) ## Context Full autonomous pipeline proved today (PR #47): Crawl4AI → headless Theseus extraction → headless Leo evaluation. These docs make the system multiplayer-ready.

m3taversal commented

2026-03-07 17:07:39 +00:00

(Migrated from github.com)

Ganymede — Code Review (via Pentagon message)

Verdict: Approve with 1 warning addressed, 1 bug flagged.

Contributor Identity (Leo's changes)

W1 (trailer injection via name): Addressed. Added validation note — strip newlines and angle brackets from contributor.yml name before using in trailers. Low risk but real attack surface.
Gitignore approach: Sufficient. Ghost email is deterministic from public GitHub handle. No sensitive data in contributor.yml.
Ghost email format: Safe. Collision-free (GitHub handles unique), injection-safe (alphanumeric + hyphens only), cleanly separated namespace from agent ghosts.
Edge case noted: Multiple contributors sharing a clone would overwrite contributor.yml. Each contributor needs their own clone (expected pattern).

Evaluate-trigger.sh (not Leo's changes)

BUG: ${DOMAIN_AGENT^} breaks on macOS bash 3.2. Apple ships bash 3.2 due to GPLv3 licensing. This uppercase-first-letter syntax requires bash 4.0+. Replace with awk or hardcode agent names. This needs fixing before Cory runs it.
All previous review items (C1, W1, W2, N1-N4) confirmed fixed.

Pentagon-Agent: Ganymede <00F28B10-062E-4863-9DD2-A5E9407B33FA>

## Ganymede — Code Review (via Pentagon message) **Verdict: Approve with 1 warning addressed, 1 bug flagged.** ### Contributor Identity (Leo's changes) - **W1 (trailer injection via name): Addressed.** Added validation note — strip newlines and angle brackets from contributor.yml name before using in trailers. Low risk but real attack surface. - **Gitignore approach:** Sufficient. Ghost email is deterministic from public GitHub handle. No sensitive data in contributor.yml. - **Ghost email format:** Safe. Collision-free (GitHub handles unique), injection-safe (alphanumeric + hyphens only), cleanly separated namespace from agent ghosts. - **Edge case noted:** Multiple contributors sharing a clone would overwrite contributor.yml. Each contributor needs their own clone (expected pattern). ### Evaluate-trigger.sh (not Leo's changes) - **BUG: `${DOMAIN_AGENT^}` breaks on macOS bash 3.2.** Apple ships bash 3.2 due to GPLv3 licensing. This uppercase-first-letter syntax requires bash 4.0+. Replace with awk or hardcode agent names. **This needs fixing before Cory runs it.** - All previous review items (C1, W1, W2, N1-N4) confirmed fixed. Pentagon-Agent: Ganymede <00F28B10-062E-4863-9DD2-A5E9407B33FA>

m3taversal commented

2026-03-07 17:08:58 +00:00

(Migrated from github.com)

Rhea — Architecture Review (via Pentagon message)

Verdict: Approve. All changes integrate cleanly with automation pipeline.

Key confirmations:

contributor.yml on VPS: Not needed. Source archive frontmatter (contributor:, contributor_github:) carries identity into the automation pipeline. When headless agents extract from contributor-submitted sources, identity comes from the source file, not from contributor.yml. The yml is purely local convenience.
Contributor: trailer format: Works with webhook pipeline. Same shape as Pentagon-Agent: trailers. Orchestrator parses both from git log --format='%(trailers)'.
Branch naming approved: contrib/{github}/{slug} is better than {agent}/contrib-{user}. Cleanly separates human contributions at the branch level. Evaluate-trigger updated to detect contrib/ branches and route to the right domain agent based on changed file paths.

Pentagon-Agent: Rhea <7C7DCDE3-51B1-404F-B9EE-C34CCF36998B>

## Rhea — Architecture Review (via Pentagon message) **Verdict: Approve. All changes integrate cleanly with automation pipeline.** Key confirmations: - **contributor.yml on VPS:** Not needed. Source archive frontmatter (`contributor:`, `contributor_github:`) carries identity into the automation pipeline. When headless agents extract from contributor-submitted sources, identity comes from the source file, not from contributor.yml. The yml is purely local convenience. - **Contributor: trailer format:** Works with webhook pipeline. Same shape as Pentagon-Agent: trailers. Orchestrator parses both from `git log --format='%(trailers)'`. - **Branch naming approved:** `contrib/{github}/{slug}` is better than `{agent}/contrib-{user}`. Cleanly separates human contributions at the branch level. Evaluate-trigger updated to detect `contrib/` branches and route to the right domain agent based on changed file paths. Pentagon-Agent: Rhea <7C7DCDE3-51B1-404F-B9EE-C34CCF36998B>