Context & learningv0.1.0

auto-map

Builds a verified, disclosure-tiered context architecture that loads repository knowledge only when needed.

WORKFLOW / 05/auto-map [scope — full refresh (default), a package/dir, or 'verify' to audit the existing map]
  1. 01

    Detect project shape and inventory existing context files and ownership.

  2. 02

    Discover real directories, commands, boundaries, and conventions.

  3. 03

    Write the smallest always-on root, path-scoped rules, nested maps, and linked deep references.

  4. 04

    Run the anti-lie validator and execute claimed commands.

  5. 05

    Report budgets, preserved human content, drift, and unverified claims.

operating envelope

Use it deliberately.

The shortest useful definition of where this skill helps—and where it should stay out of the way.

Use when

  • A project lacks a trustworthy context map.
  • Architecture-level changes moved packages, commands, or boundaries.
  • An existing map needs a drift audit or the pipeline has just shipped meaningful work.

Do not use when

  • A routine edit did not change the project architecture.
  • The goal is to invent coding policy rather than map observed reality.
  • The user did not request this durable project-memory mutation and no invoked workflow composes it.

output contract

What must be true when it stops.

Produces

  • Lean root CLAUDE.md
  • Path-scoped .claude/rules/*.md files
  • Nested CLAUDE.md files for significant directories
  • Verified command and drift report with per-tier line counts

Guarantees

  • Paths, exports, routes, and commands are checked against the repository.
  • Root CLAUDE.md stays at or below 150 lines, rules at 120, and nested maps at 100.
  • Deep references are linked for on-demand reading rather than imported at startup.
  • Generated sections update without clobbering human-written instructions.
  • Commands that cannot run are labeled unverified instead of asserted true.

Honest failure states

  • drift — a mapped fact no longer matches repository reality
  • unverified — a claimed command could not be executed
  • over_budget — content belongs in a deeper disclosure tier
  • unsafe_clobber — existing human-owned content cannot be preserved confidently

enforcement

Know which claims are executable.

Scripts are linked when this skill owns deterministic machinery. The remaining rules are explicit operating contracts and must not be marketed as hooks.

install and invoke

One skill, three honest surfaces.

skills.sh

Available

Universal skill installation, including Claude Code and Codex.

npx skills add https://github.com/ulpi-io/skills-autonomous-engineering --skill auto-map

Claude Code plugin

Available

Install the full plugin, then invoke /auto-map or let routing select it from context.

Claude installation →

Codex plugin

Work in progress

A work in progress on the codex-native-plugin branch — build it, start a new session, then invoke $autonomous-engineering:auto-map.

Codex installation →