chore: strip down AGENTS.md

[johnnygreco]

Summary

• Strip AGENTS.md from ~626 lines to ~48 lines, removing verbose development instructions, code style guidelines, and testing patterns that duplicate CLAUDE.md
• Keep only the concise sections: identity, layering, core concepts, design principles, structural invariants, and development commands
• Make CLAUDE.md a symlink to AGENTS.md so there's a single source of truth

Closes #430

[greptile-apps]

Greptile Summary

This PR consolidates agent guidance documentation by stripping AGENTS.md from ~626 lines to ~46 lines and replacing CLAUDE.md with a filesystem symlink pointing to AGENTS.md. Both Claude Code and other agents now read the same concise file.

• AGENTS.md is reduced to six focused sections: identity, layering, core concepts, design principles, structural invariants, and make development commands
• CLAUDE.md is converted from a 3-line file using Claude Code's @AGENTS.md include syntax to a true git symlink (mode 120000), ensuring a single source of truth without any drift risk between the two files
• Removed content includes SPDX license header instructions, from __future__ import annotations guidance, detailed code style rules, lazy loading / TYPE_CHECKING patterns, naming conventions, testing patterns, common pitfalls, and the annotated key-files list — the PR treats these as either captured by tooling (ruff, pre-commit) or too verbose for agent guidance
• The stripped AGENTS.md still correctly captures the architectural contract ("declare, don't orchestrate"), the three-package namespace layering, import direction invariants, and the four canonical make targets agents need for daily work

Confidence Score: 5/5

• This PR is safe to merge — it is a documentation-only change with no impact on runtime code.
• Only documentation files are modified. The symlink approach is correct (relative path resolves to the same directory, git mode 120000), and the stripped content is either enforced by tooling (ruff, pre-commit) or intentionally omitted per the PR author's judgment. No logic, tests, or production code is touched.
• No files require special attention.

Important Files Changed

Filename	Overview
AGENTS.md	Stripped from ~626 lines to ~46 lines, retaining only identity, layering, core concepts, design principles, structural invariants, and development commands. Notable guidance removed includes SPDX license header requirements, from __future__ import annotations, detailed code style/import rules, lazy loading patterns, testing patterns, and the key files reference list.
CLAUDE.md	Converted from a 3-line file using Claude Code's @AGENTS.md include directive to a proper filesystem symlink (git mode 120000) pointing to AGENTS.md, establishing a single source of truth.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["Claude Code reads CLAUDE.md"] -->|"symlink (git mode 120000)"| C["AGENTS.md\n(~46 lines)"]
    B["Other agents read AGENTS.md"] --> C
    C --> D["## Identity"]
    C --> E["## The Layering Is Structural\nconfig → engine → interface"]
    C --> F["## Core Concepts\nColumns / Samplers / Seed datasets / Processors / Models / Plugins"]
    C --> G["## Core Design Principles\nDeclarative config · Registries · Error normalization"]
    C --> H["## Structural Invariants\nImport direction · Fast imports · No relative imports · Typed · Tested"]
    C --> I["## Development\nmake check-all-fix · make test · make update-license-headers · make perf-import"]

Loading

_{Last reviewed commit: 391c757}