core-labs/core
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
core/CLAUDE.md
Shay 63464144c5 docs: consolidate agent architectural governance into AGENTS.md 
This change removes duplicate provider-specific rules across CLAUDE/GPT55/GROK files and replaces them with thin, provider-neutral shims that point back to the canonical AGENTS.md for all architectural invariants, PR discipline, and trust boundaries.
2026-06-30 10:55:48 -07:00

1.3 KiB
Raw Blame History

CORE Agent Instructions for Claude

Read this file before modifying the repository.

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

Session start

  1. Read AGENTS.md.
  2. Read docs/runtime_contracts.md.
  3. Read the most recent HANDOFF-*.md from the last 3 days if one exists and is relevant.
  4. Confirm repository root and inspect the working tree before editing.
  5. Run:
core test --suite smoke -q
  1. State the task scope before making changes:
    • which module(s) you will touch
    • which invariant or contract you must preserve

Working rules

  • Do not invent alternate architecture, alternate invariants, or alternate memory rules.
  • Use the smallest relevant validation lane first, then broader lanes as required by change scope.
  • For docs/config-only changes, smoke is usually sufficient unless the change affects executable paths, tests, CLI behavior, or generated artifacts.
  • Prefer small, load-bearing changes.
  • Use AGENTS.md as the source of truth for architecture, invariants, validation, and PR standards.

Session end

When a session produced meaningful implementation or architectural analysis, write or update a handoff document using the repo’s handoff template and current naming convention.