anagramsoft

Public edition of Magaran Software's projects/ root design — a hierarchical agent-context structure for AI-assisted development across many repos.

Purpose

This template provides a hierarchical CLAUDE.md/AGENTS.md structure that is automatically loaded by Claude Code when working in any project under your ~/projects/{org}/ root. It serves as a single source of truth for organization-wide and architecture-level conventions, reducing redundant context across projects.

See AGENTS.md for the agent-context content itself (auth posture, signing, bypass-team pattern, baseline checks).

Background

"AnagramSoft" is not a real entity — it's the anagram-of-Magaran public rendition of Magaran Software's internal projects/ root, stripped of company-specific architectures and projects. Fork as a starting point for your own org or personal multi-repo workspace.

Structure

~/projects/{org}/
├── CLAUDE.md -> AGENTS.md            # Org-wide agent context
├── .ai/                              # Shared agent assets
│   ├── grammar/                      #   writing-style spec (caveman)
│   └── memories/                     #   procedural how-tos referenced by AGENTS.md
├── {app_architecture}/
│   ├── CLAUDE.md -> AGENTS.md        # Architecture-specific agent context
│   └── {project_name}/               # Project repo (not tracked here)

Projects are cloned into their respective architecture folder: ~/projects/{org}/{app_architecture}/{project_name}.

What This Repo Tracks

• Organization-level CLAUDE.md / AGENTS.md
• Architecture-category folders and their CLAUDE.md / AGENTS.md (examples/ is a placeholder — replace with your own categories)
• .ai/grammar/ — agent writing-style specifications
• .ai/memories/ — procedural how-tos referenced from AGENTS.md
• .gitignore rules that exclude project repositories

What This Repo Does NOT Track

• The project repositories themselves — those are independent git repos cloned into the architecture folders.

Adding a New Architecture Category or Project

See .ai/memories/adding-projects.md for the full procedure. New AGENTS.md files should follow the writing-style spec at .ai/grammar/caveman.md.

A newly cloned project automatically inherits the org and architecture CLAUDE.md context.

Forking This Template

1. Replace {org} placeholders with your GitHub org slug (or username).
2. In AGENTS.md, replace <owner-email> and <owner-key-fingerprint> with your maintainer's email and GPG signing key fingerprint.
3. Replace <hotfix-bypass-team> and <pr-bypass-team> with your bypass team slugs (or remove the bypass-teams section if you don't use that pattern).
4. Replace the examples/ directory with real architecture-category folders for your stack.