agentleFS
sebas8824sebas8824/sdd-harness/.claude/skills/project-architecture/SKILL.md

project-architecture

Skill1 starsChanged 3 months agoMITView on GitHub

<project> system architecture and boundary invariants. Use when designing or touching module boundaries, public contracts, tenancy, persistence, or anything that crosses service lines. Enforces the invariants listed in AGENTS.md.

7 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

<project> architecture

Stub — fill this in. This is the on-demand half of AGENTS.md: the invariants live there in one line each, and the reasoning, the examples, and the checklists live here. Rename the skill to your project (<project>-architecture) and update .claude/skills/README.md.

The shape

flowchart LR
    A["<module A>"] --> B["<module B>"]
    B --> C["<store>"]

<Two paragraphs: what each component owns, and the one boundary that defines the system.>

Invariants, with their reasoning

1. <Invariant, stated as an absolute>

Why. <The failure this prevents, concretely.> What violating it looks like. <The tempting shortcut a reviewer must recognize.> The right fix instead. <Where the change belongs when someone reaches for the shortcut.>

2. <…>

Where things go

ConcernLives inNever in
<…><…><…>

Design checklist for a cross-boundary change

  • <Does it move identity or tenancy? Then where does it come from?>
  • <Does it add a public contract? What must be regenerated in the same PR?>
  • <Does it need an ADR? (multi-module, non-obvious trade-off, sensitive path)>

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.