Home / ganyuanran / aegis · skills/establishing-project-context/SKILL.md · GitHub

establishing-project-context skillA

establishing-project-context is agent-read markdown (skill) from ganyuanran/aegis: Use when the user asks to establish shared project language, or project work exposes a conflicting, renamed, or deprecated domain term that needs active semantic modeling. Routine small tasks stay on the fast path..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Establishing Project Context

## Overview

Maintain project domain language in `CONTEXT.md` so humans and agents use the
same canonical terms. This skill is the single active-modeling and write-policy
owner; it does not own passive glossary reads.

`CONTEXT.md` is terminology infrastructure, not Aegis governance, architecture,
requirements, task state, session memory, or runtime authority. Those retain
their current project owners.

## Passive Consumption vs Active Modeling

Passive consumption is a cheap habit of the task-owning workflow:

1. For non-trivial project work, check `CONTEXT-MAP.md`, then relevant root or
   bounded-context `CONTEXT.md` files when present.
2. Read only relevant active terms and relationships; index first when large.
3. Treat open ambiguities as unresolved data, not active truth.
4. Continue the owning workflow without loading this skill.

Load this skill only for active modeling when at least one signal exists:

- a newly resolved domain concept
- a vague, overloaded, or conflicting term
- an approved rename, merge, deprecation, or meaning change
- authority, code, tests, or public language contradict the glossary
…

Read the whole file at its exact version.

How to install

Latest version
mdr add ganyuanran/aegis/establishing-project-context@git:20260809.f62395b
Exact content
mdr add ganyuanran/aegis/establishing-project-context@sha256:9988bbfaa48a266a

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_4kfrzbmxx4sxsvak.svg)](https://markdownregistry.com/a/art_4kfrzbmxx4sxsvak)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260809.f62395b latest2026-08-09 f62395b 5,826 BA view · diff
git:20260723.88b8ec92026-07-23 88b8ec9 5,799 BA view · diff
git:20260718.0d0be0b2026-07-18 0d0be0b 5,797 BA view · diff
git:20260510.b9bb3172026-05-10 b9bb317 3,190 BA view · diff
git:20260506.01d09be2026-05-06 01d09be 3,258 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5826 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ganyuanran/aegis · 1,280 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_4kfrzbmxx4sxsvak
GET https://markdownregistry.com/api/v1/resolve?ref=ganyuanran/aegis/establishing-project-context
GET https://markdownregistry.com/api/v1/blob/9988bbfaa48a266adabafdc584a10120473f271d8714f0ca58fb69ec0cc10268

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from ganyuanran/aegis

AGENTS.md agents
ganyuanran/aegis · AGENTS.md
git:20260813.0c73270 · audit A · 1,280 stars
CLAUDE.md claude
ganyuanran/aegis · CLAUDE.md
git:20260813.0c73270 · audit A · 1,280 stars
anti-entropy-governance skill
ganyuanran/aegis · skills/anti-entropy-governance/SKILL.md · Use when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or…
git:20260830.8e0cee3 · audit A · 1,280 stars
brainstorming skill
ganyuanran/aegis · skills/brainstorming/SKILL.md · Use when defining ambiguous or high-complexity new features, product behavior, UI/component design, architecture…
git:20260916.9a51c7a · audit A · 1,280 stars
communicating-concisely skill
ganyuanran/aegis · skills/communicating-concisely/SKILL.md · Use when the user asks for caveman mode, fewer tokens, brief responses, compressed communication, or otherwise…
git:20260723.88b8ec9 · audit A · 1,280 stars
dispatching-parallel-agents skill
ganyuanran/aegis · skills/dispatching-parallel-agents/SKILL.md · Use when facing 2+ independent tasks without a written plan, with no conflicting shared mutable state or sequential…
git:20260920.8265b5c · audit A · 1,280 stars
executing-plans skill
ganyuanran/aegis · skills/executing-plans/SKILL.md · Use when executing a written implementation plan across sessions or with review checkpoints. Small or single-slice…
git:20260828.f7ae3a7 · audit A · 1,280 stars
finishing-a-development-branch skill
ganyuanran/aegis · skills/finishing-a-development-branch/SKILL.md · Use when verified work needs integration or cleanup of an existing task-created branch/worktree, or the user explicitly…
git:20260809.f62395b · audit A · 1,280 stars
first-principles-review skill
ganyuanran/aegis · skills/first-principles-review/SKILL.md · Use when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints…
git:20260905.878cac9 · audit A · 1,280 stars
goal-framing skill
ganyuanran/aegis · skills/goal-framing/SKILL.md · Use when the user explicitly sets an Aegis goal with /aegis-goal, Aegis goal:, or asks to define goal, success…
git:20260723.88b8ec9 · audit A · 1,280 stars
long-task-continuation skill
ganyuanran/aegis · skills/long-task-continuation/SKILL.md · Use when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before…
git:20260916.9a51c7a · audit A · 1,280 stars
receiving-code-review skill
ganyuanran/aegis · skills/receiving-code-review/SKILL.md · Use when receiving code review feedback before implementing suggestions, especially when feedback is unclear, risky…
git:20260723.88b8ec9 · audit A · 1,280 stars

Every file in ganyuanran/aegis

Browse by kind, by grade A, or by owner.