core-labs/core
core-labs/core
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
core/CLAUDE.md
Shay fc38a6c7ee
Some checks failed
lane-shas / verify pinned lane SHAs (pull_request) Successful in 3m15s
Details
smoke / smoke (-m "not quarantine") (pull_request) Failing after 21m42s
Details
docs(governance): CI/CD Runner Architecture doctrine — local Mac Act runner 
Ports the runner-migration doctrine (authored by the Gemini session against
a stale checkout; grafted here onto current main so the #40-era Local-First
protocol section is preserved, not clobbered):

- CI jobs dispatch to a local Act runner on the primary developer's Mac
  (label ubuntu-latest:host = native macOS host execution; the ubuntu name
  is a fiction — no Linux-only steps).
- The GCP e2-micro server-side runner was REMOVED 2026-07-16; never
  re-provision it (1GB RAM, OOM class). A waiting queue while the Mac is
  asleep is intentional — pre-push local gates are the real discipline.
- Workflows remain canonical and install the locked universe (uv sync
  --locked, committed uv.lock). GitHub mirror Actions are billing-locked
  dead signals.
- CLAUDE.md gains a one-line pointer (policy stays in AGENTS.md).

[Verification]: smoke suite passed locally (175 passed); docs-only.
2026-07-16 10:31:57 -07:00

726 B
Raw Blame History

CORE Agent Instructions for Claude

AGENTS.md is the canonical governance file. If this file conflicts, follow AGENTS.md.

Startup: read AGENTS.md, docs/specs/runtime_contracts.md, inspect working tree, use the smallest validation lane. CRITICAL: Remote is core-gitquarters.acbcontent.org. Do not use GitHub/gh CLI. Use Forgejo tools/gitea CLI. CI: local-first — pre-push gates are mandatory; CI jobs run on the developer's local Mac Act runner, never on the Forgejo server (see AGENTS.md §CI/CD Runner Architecture).

Before non-trivial edits, apply the protocol in AGENTS.md.

Do not place architecture, invariants, memory rules, or alternate workflow policy here. Update AGENTS.md instead.