compile-agents-context

name	compile-agents-context
description	Generate and maintain AGENTS.md as a living project context document by scanning the repository, discovering agents/skills, and extracting conventions. Use when initializing Codex context for a repo, refreshing stale AGENTS.md, or after significant project structure changes. Use when this capability is needed.
metadata	{"author":"cmcp0"}

Compile Agents Context

Overview

Use this skill to run the old init command workflow as a Codex-native skill. It standardizes AGENTS discovery and regeneration with explicit options.

Inputs

• scan_depth: shallow, medium, or deep (default medium)
• include_dependencies: true or false (default true)
• auto_watch: true or false (default true)

Workflow

1. Discover project context

• Read root project files (README, manifests, config files).
• Scan directories according to scan_depth:
  • shallow: root + first-level key folders.
  • medium: default, includes feature/service folders.
  • deep: broad scan for full architecture and conventions.

2. Discover agents and skills

• Search for agents in .cursor/agents, .cline/agents, .agents, agents, .ai, prompts, system-prompts.
• Search for skills in .cursor/skills, .codex/skills, .agents/skills, and user-level paths if accessible.
• Capture each discovered item with name, location, purpose, and trigger scenarios.

3. Extract conventions

• Capture coding and formatting standards from lint/format configs.
• Capture architecture, testing, and build/deploy patterns from project files and docs.
• Include dependency context only when include_dependencies=true.

4. Generate or refresh AGENTS.md

• Write a complete AGENTS.md in repository root.
• Include project overview, stack, structure, agent ecosystem, skill registry, conventions, and workflows.
• Preserve existing high-signal custom instructions when regenerating.

5. Configure auto-maintenance rule (optional)

• If auto_watch=true, create/update .cursor/rules/agents-maintainer.md.
• Define a rule that prompts AGENTS refresh when significant project structure changes occur.

Reference

Use /Users/carloscaceres/local/marius/code_samples/credit-applications-hub/.agents/skills/context-compilation-guide/SKILL.md for the detailed section template and generation depth guidance.

Output Contract

• Updated /Users/carloscaceres/local/marius/code_samples/credit-applications-hub/AGENTS.md
• Optional /Users/carloscaceres/local/marius/code_samples/credit-applications-hub/.cursor/rules/agents-maintainer.md
• Short summary listing files updated and discovery statistics

---

Source: cmcp0/credit-applications-hub — distributed by TomeVault.