project-architect: Instructions file for Claude Code

CLAUDE.md

project-architect CLAUDE.md is an instructions file for Claude Code from arnwaldn/project-architect. It costs 818 tokens per session, scanned A, original, MIT.

A Claude Code project-planning instruction set for preparing a software project from initial assessment through a pre-development approval step. It adapts the questions and deliverables to four project sizes: S, M, L, and XL.

In plain words
What is it for?
Use it with /project-architect to qualify a project, inspect existing technology, define requirements and UX, plan the technical architecture, and produce files such as CLAUDE.md and implementation-roadmap.md.
Why use it?
It organizes discovery, requirements, design, architecture, schedule, and budget before coding begins. This helps teams carry a consistent plan into implementation.

Instructions file for Claude Code

Written for Claude Code: PostToolUse hook event. Also seen: mentions .claude-plugin; mentions CLAUDE.md; mentions Claude Code.

This is arnwaldn/project-architect's own configuration. It tells Claude Code how to work on project-architect itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything project-architect configures →

Reuse

Borrowing it

Nothing to install: this file belongs to arnwaldn/project-architect. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/arnwaldn/project-architect/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/arnwaldn/project-architect

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for project-architect CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/arnwaldn/project-architect/claude-md/github.svg)](https://agentmods.dev/instructions/arnwaldn/project-architect/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/arnwaldn/project-architect/claude-md"><img src="https://agentmods.dev/badge/instructions/arnwaldn/project-architect/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for project-architect CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/arnwaldn/project-architect/claude-md"><img src="https://agentmods.dev/badge/instructions/arnwaldn/project-architect/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 818 This file is loaded in full into every session.
When invoked 818 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00818 $0.00818
Opus 5.5 $0.00327 $0.00327
Sonnet 5.5 $0.00164 $0.00164
Haiku 4.5 $0.00082 $0.00082

Measured 2mo ago against content hash 011e9be7b87b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

project-architect CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 70 lines

How it starts

The opening of the file, as written. The whole thing — 70 lines — stays where its author put it; the contents beside it link to each section on GitHub.

project-architect — Plugin Claude Code

Plugin de préparation de projet de développement, de la qualification initiale à la gate pré-dev. Une seule commande /project-architect, workflow adaptatif S/M/L/XL.

Architecture

8 phases séquentielles :

  1. QUALIFIER — Taille du projet (S/M/L/XL) et Go/No-Go
  2. COMPRENDRE — Contexte, existant, contraintes
  3. STRATÉGISER — Stratégie et positionnement
  4. SPÉCIFIER — Cahier des charges fonctionnel
  5. DESIGNER — Brief UX/UI et direction artistique (24 questions, 9 blocs)
  6. ARCHITECTURER — Architecture technique
  7. PLANIFIER — Planning et budget
  8. VALIDER — Gate pré-dev et fichiers-pont (CLAUDE.md, implementation-roadmap.md)

Matrice adaptative : data/adaptation-matrix.json contrôle quelles questions et quels livrables s'appliquent selon la taille S/M/L/XL. Invariant à préserver : les items sont monotones (S <= M <= L <= XL) pour chaque phase.

Fichiers clés

Fichier Rôle
commands/project-architect.md Skill principal (854 lignes, 82 questions)
data/adaptation-matrix.json Matrice phases x tailles (308 items)
agents/discovery-auditor.md Audit de l'existant technique (sonnet)
agents/spec-architect.md Cahier des charges (sonnet)
agents/tech-architect.md Architecture technique (sonnet)
agents/pre-dev-validator.md Validation pré-dev (haiku)
templates/*.md Les 7 templates de livrables
docs/referentiel-workflow.md Le référentiel en 14 phases dont les 8 phases sont tirées
tools/*.py Échafaudage hors plugin : tests et générateurs

Conventions

  • Questions numérotées Q{phase}.{num} (ex. Q5.14), continues par phase — vérifié par le test T5
  • Noms de phases en français (QUALIFIER, COMPRENDRE, etc.)
  • Items de la matrice monotones : S <= M <= L <= XL — vérifié par T3
  • Templates avec placeholders {variable}, accolades équilibrées — vérifié par T8
  • Agents référencés par chemin relatif dans .claude-plugin/plugin.json
  • Français accentué dans tout ce qui est lu par un humain
  • Aucune dépendance externe : bibliothèque standard Python uniquement

Read the full file on GitHub · 70 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 70 lines · 818 tokens per session scan A 011e9be7b87b

Subscribe to this mod's changes

project-architect CLAUDE.md is an instructions file published in the GitHub repository arnwaldn/project-architect (1 stars, last pushed 2mo ago), licensed MIT. It adds 818 tokens to every session, about $0.0033 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,461 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,750 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 4,261 tokens