Establishing Project Context

Mantiene un glossario di dominio canonico CONTEXT.md affinché umani e agenti condividano i termini.

di GanyuanRan · GanyuanRan/Aegis

Promosso ★ 8.8/10

Establishing Project Context — Mantiene un glossario di dominio canonico CONTEXT.md affinché umani e agenti condividano i termini.

Cosa fa

Mantiene la terminologia del dominio del progetto in un glossario canonico CONTEXT.md in modo che umani e agenti di codifica utilizzino gli stessi termini, classificando ogni cambiamento per grado di evidenza e se è un fatto assodato o una decisione aperta prima di scrivere. Si attiva quando l'utente chiede di stabilire un linguaggio di progetto condiviso, o quando il lavoro fa emergere un termine di dominio risolto, vago, in conflitto, rinominato o deprecato che necessita di modellazione semantica attiva. Limita il file a termini e relazioni, escludendo percorsi di codice, timestamp e log.

Rapporto di test

Recuperato SKILL.md e il suo CONTEXT-FORMAT.md di riferimento tramite raw GitHub (entrambi HTTP 200); il frontmatter si analizza con name+description, i percorsi usano segnaposto <project-root>, e il corpo contiene una guida esplicita anti-prompt-injection piuttosto che qualsiasi problema di sicurezza. Per l'output ho eseguito un compito (dividere un termine ambiguo "account" in Customer/User) due volte: un CONTEXT.md di baseline e uno che seguiva la skill. La baseline conteneva percorsi di implementazione, un timestamp e un log TODO/note e manteneva "Account" come voce attiva; seguendo la skill ha rimosso tutti e tre (entrambi i documenti li proibiscono esplicitamente), ha applicato la forma alias canonica _Avoid_ e una sezione Resolved Ambiguities, e ha classificato correttamente il cambiamento come evidenza A + fatto, quindi ha scritto direttamente senza chiedere. I giudizi di attivazione (3 dovrebbero attivarsi, 2 non dovrebbero) si sono tutti risolti correttamente.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/GanyuanRan/Aegis.git /tmp/establishing-project-context-src
mkdir -p ~/.claude/skills
cp -R /tmp/establishing-project-context-src/skills/establishing-project-context ~/.claude/skills/establishing-project-context
# Self-contained: SKILL.md + CONTEXT-FORMAT.md, no external deps, tools, or API keys.
# Part of the Aegis "method pack"; works standalone as a single skill.

Comandi e prompt di esempio

  • /establishing-project-contextMantiene un glossario di dominio canonico CONTEXT.md affinché umani e agenti condividano i termini.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Establish shared language for this new project
  • Create a glossary of domain terms for this codebase
  • Define our project's key domain terminology together