Menu
Session initialization — run at the start of EVERY session before any other action.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Karpathy-inspired behavioural guidance for non-trivial coding, debugging, review, or refactor work. Use to surface assumptions, keep changes minimal, and define verifiable success criteria.
Manage dependency-aware multi-session workflows in agent_roadmaps/.
Orchestrate build workflows. Environment setup, compilation, and testing.
Validate constraint compliance at any time during development.
Create a new project from the repo_template. Supports Python, C++/CUDA, and Hybrid projects. Template-only skill.
Add dependencies. Poetry for Python, CPM through CMake for C++.
| name | init |
| description | Session initialization — run at the start of EVERY session before any other action. |
Session initialization. FIRST ACTION every session — skipping is a critical failure.
.ai/bin/agent-init --platform claude
.ai/project.yml for project type (Python / C++ / hybrid); falls back to heuristic scan..ai/capabilities.yml:
.claude/skills/ and .ai/skills/.ai/bin/agent-* wrappers are executable.ai/session_state.json and mirrors it to .claude/session_state.json.| Symptom | Meaning | Resolution |
|---|---|---|
| Capability audit fails | Required plugin/skill/MCP missing | Install missing item, re-run /init |
[MISS] <key> in output | Constraint file not found | Restore .ai/constraints/<key>.md |
| Session gate blocks Bash/Write | session_state.json absent or audit failed | Re-run /init |
After a successful /init, the pre-tool-use hook allows all operations.
After a failed audit, Write/Edit/Bash are blocked until /init passes.
Read/Glob/Grep are always permitted for exploration.
common/instruction-hierarchy — scoped repository-local precedencecommon/git-workflow — protected branches, commit attributioncommon/session-discipline — session lifecycle rulescommon/closure-discipline — rigorous review and evidence before closurecommon/karpathy-guidelines — behavioural guardrailscommon/mcp-integration — Context7 mandatory usagecommon/ascii-only — identifier encodingcommon/agentic-team — parallel sub-agent policycommon/roadmap-awareness — if an active roadmap is detectedPlus language-specific sets for Python / C++ / hybrid (see .ai/scripts/session_init.py
resolve_constraints() for the full matrix).