Session bootstrap - read project context (README, AGENTS, docs, skills, agents). Quick project orientation without full codebase exploration.
Reads project context files and git state to provide quick orientation without deep codebase analysis.
/plugin marketplace add 0xDarkMatter/claude-mods/plugin install 0xdarkmatter-claude-mods@0xDarkMatter/claude-modsRead yourself into this project. Fast, direct file reads - no caching overhead.
Read these files simultaneously (skip any that don't exist):
| File | Purpose |
|---|---|
README.md | Project overview |
AGENTS.md | Agent instructions |
CLAUDE.md | Project-specific rules |
docs/PLAN.md | Current plan (first 50 lines) |
.claude/session-cache.json | Saved session state |
Run these globs simultaneously to discover extensions:
docs/*.md
commands/*.md OR .claude/commands/*.md
skills/*/SKILL.md OR .claude/skills/*/SKILL.md
agents/*.md OR .claude/agents/*.md
One bash command for live state:
git branch --show-current 2>/dev/null && git status --porcelain 2>/dev/null | wc -l
Format and display the results.
š Project Synced: [project-name]
## Summary
[1-2 paragraph narrative summary based on README.md and AGENTS.md:
- What this project is and its purpose
- Key conventions or guidelines from AGENTS.md
- Current state (active plan, recent work, etc.)
- Any special instructions from CLAUDE.md that affect how to work]
## Quick Reference
| Category | Items |
|----------|-------|
| **Project** | [name] - [one-line purpose from README] |
| **Key Docs** | [list of docs/*.md filenames] |
| **Commands** | [list of /command names from .claude/commands/] |
| **Skills** | [list of skill names from .claude/skills/] |
| **Agents** | [list of agent names from .claude/agents/] |
| **Plan** | [Step X/Y - description] or "No active plan" |
| **Saved State** | [timestamp] or "None" |
| **Git** | [branch], [N] uncommitted files |
## Recommended Next Steps
Based on the current state, suggest 2-3 logical actions:
1. **[Primary action]** - [why this makes sense given current state]
2. **[Secondary action]** - [context]
3. **[Tertiary action or "Ready for new task"]**
Examples of recommendations:
- If saved state exists: "Run `/plan --load` to restore your previous session tasks"
- If plan exists and in-progress: "Continue with Step N: [description]"
- If uncommitted changes: "Review and commit staged changes"
- If no plan/state: "Ready for new task - no pending work detected"
ā No README.md found - project overview unavailable
ā¹ No docs/ directory - documentation not set up
ā¹ Fresh project - no Claude configuration found
Consider: /init to set up CLAUDE.md
| Command | Relationship |
|---|---|
/sync | This command - Read project context |
/plan --load | Restore TodoWrite + plan state from saved JSON |
/plan --save | Persist TodoWrite + plan state to JSON |
/plan --status | Quick status dashboard (read-only) |
/plan | Create or manage project plans |
New Session
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
1. /sync ā Read project context (always)
2. /plan --load ā Restore saved tasks (if continuing work)
3. ... work ...
4. /plan --status ā Check status anytime
5. /plan --save ā Save before ending session