agentleFS
Shreyash3007Shreyash3007/aegis/skills/00-foundation/skill.md

00-foundation

Skill0 starsChanged 29 days agoMITView on GitHub

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Brain protocol: read brain/context-window.md before any edit.

    line 29
  2. Distinctive:

    Dual mode: every step lists the CLI command (Runtime mode) and the manual fallback (human runs command, pastes output).

    line 31
  3. Distinctive:

    Determinism: never write timestamps into generated artifacts (A1.2).

    line 34
  4. Distinctive:

    Honesty: if a step cannot be performed in the current environment level, say so explicitly and label outputs UNVERIFIED.

    line 35

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
skill.md

SKILL-00: FOUNDATION (Master Skill)

Purpose

Set up Aegis in any repo, lock context, recover sessions, ingest existing codebases. Everything else in Aegis depends on this family being correct.

Sub-Skills

IDFilePurposeHuman gate
00a00a-installer.mdOne-command install, environment detectionOverwrite prompt only
00b00b-context-lock.mdSetup interview + locked manifestThe interview itself
00c00c-resume.mdCrash/session recovery with verified integrityIntegrity failure
00d00d-brownfield.mdReverse-discovery: brain FROM existing codeInference confirmation
00e00e-ask-aegis.mdNext-action advisor: ONE recommended step + evidenceGate approval / loop escalation
00f00f-aegis-guide.mdInteractive onboarding: agent does setup, explains, asksConsent + autonomy choice

Shared Rules (all sub-skills)

  1. Brain protocol: read brain/context-window.md before any edit; write outputs to the designated brain files; state changes ONLY via the aegis CLI.
  2. Dual mode: every step lists the CLI command (Runtime mode) and the manual fallback (human runs command, pastes output). Never pretend enforcement exists in Manual mode.
  3. Determinism: never write timestamps into generated artifacts (A1.2).
  4. Honesty: if a step cannot be performed in the current environment level, say so explicitly and label outputs UNVERIFIED.

Routing

  • greenfield: 00a -> 00b -> 01a
  • brownfield: 00a -> 00b -> 00d -> (01a for new features | 07a for hardening)
  • crash/interruption: 00c -> checkpoint target
  • unsure / blocked / cold session: 00e (ask-aegis) -> the one legal next action
  • "guide me" / first contact / knows nothing: 00f (aegis-guide) -> configured + understood setup

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.