mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-10-09 03:17:54 +00:00
32a0da53a4
Sprint 3 closure for v2.8.0. Brings the 2 new top-level domains (business-operations + commercial) to release-ready by extending the cross-platform sync infrastructure, the docs generator, and the MkDocs nav to recognize them. ## Cross-platform sync (codex / gemini / hermes) - scripts/sync-codex-skills.py — SKILL_DOMAINS extended with business-operations + commercial. Regenerated .codex/skills/ symlinks for 15 new skills + .codex/skills-index.json with full descriptions. - scripts/sync-gemini-skills.py — DOMAIN_MAP extended with all 5 v2.7.0+ v2.8.0 top-level domains (productivity, marketing-top-level, research, business-operations, commercial). +30 items synced. - scripts/sync-hermes-skills.py — DOMAIN_DIRS extended with business-operations + commercial. ## Docs generation (Pass 2 command/agent discovery) scripts/generate-docs.py extended with: - DOMAINS dict extended with business-operations (sort=13) and commercial (sort=14) entries. - Pass 2 for agent discovery — walks <domain>/agents/<agent>.md (v2.8.0 pattern), in addition to <domain>/<plugin>/agents/<agent>.md (legacy pattern). - Pass 2 for command discovery — walks <domain>/commands/<cmd>.md (v2.8.0 pattern) AND <domain>/<skill>/commands/<cmd>.md (v2.7.0 pattern). Previously, only root-level commands/*.md were discovered; 35 commands were orphaned (v2.7.0 capture/pulse/landing/etc. + all v2.8.0 commands). Result: 311 skill pages + 75 agent pages + 69 command pages = 455 total. Up from 311 + 73 + 34 = 418. ## MkDocs nav mkdocs.yml updated with: - Business Operations section (7 sub-skill nav entries) - Commercial section (8 sub-skill nav entries) - 2 new orchestrator agents added to Agents nav - 17 new v2.8.0 slash commands added to Commands nav MkDocs build succeeds (non-strict) in ~17s. Strict mode flags 3 pre- existing broken links in older content (cs-aeo, grill-with-docs) — out of scope for v2.8.0. ## CHANGELOG.md v2.8.0 entry rewritten from "Sprint 1 only" to the full Sprint 1 + 2 + 3 view. All 13 sub-skills documented with canon attribution. Stats updated: - 313 -> 328 skills (+15) - 12 -> 14 top-level domains - 60 -> 77 slash commands (+17) - 402 -> 441 Python tools (+39) - 542 -> 581 reference docs (+39) - 46 -> 48 cs-* agents (+2) - 57 -> 59 marketplace plugins (+2) - 34 -> 69 documented commands in MkDocs (+35) ## Root CLAUDE.md Updated Current Scope + Current Version to reflect v2.8.0 (released) status. Sprint 1 "in-flight" -> "complete". Counts updated to 328 skills / 441 tools / 77 commands. ## Per-skill audit (scripts/audit_skills.py) Ran across 329 total skills. All 13 v2.8.0 sub-skills audited with skill_review_checklist_runner.py: 1 score 5/6, 7 score 4/6, 4 score 3/6, 1 score 2/6 (knowledge-ops). Dominant failure mode: rule #2 "SKILL.md under 100 lines" — known tension with our deliberate Forcing-question library depth (mandatory per user direction). Tracked as ADVISORY for skills that deliberately expose extended grill discipline. ## Plugin manifest validation scripts/check_plugin_json.py --all passes (exit 0) for all 47 plugin manifests including the 2 new ones. The PR #690 validator recognizes the source extension field per CLAUDE.md. https://claude.ai/code/session_015bBb4HzWCf5HH5QK2TGtnW
85 lines
3.1 KiB
Markdown
85 lines
3.1 KiB
Markdown
---
|
|
title: "/cs-handoff — Slash Command for AI Coding Agents"
|
|
description: "/cs:handoff <next-session-focus> — Compact the current conversation into a handoff document for a fresh agent. Tailored to next-session focus. Slash command for Claude Code, Codex CLI, Gemini CLI."
|
|
---
|
|
|
|
# /cs-handoff
|
|
|
|
<div class="page-meta" markdown>
|
|
<span class="meta-badge">:material-console: Slash Command</span>
|
|
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/2-claude-skills/tree/main/engineering/handoff/commands/cs-handoff.md">Source</a></span>
|
|
</div>
|
|
|
|
|
|
**Command:** `/cs:handoff <next-session-focus>`
|
|
|
|
Hand off the current conversation to a fresh agent. Tailored to the focus argument.
|
|
|
|
## When to Run
|
|
|
|
- Ending a long session; want continuity
|
|
- Switching contexts mid-flight
|
|
- Handing work to another team/person/agent
|
|
- Starting a parallel session that needs current state
|
|
|
|
## The Five Sections (per Matt Pocock)
|
|
|
|
1. **Goal of next session** — outcome the next session must achieve (tailored to focus)
|
|
2. **State of play** — done / in-progress / blocking, with paths + refs
|
|
3. **Open decisions** — what the next agent must decide, with options + current leans
|
|
4. **Skills to use** — concrete list from `skill_recommender.py`
|
|
5. **Artifacts** — paths + URLs ONLY (never inline content)
|
|
|
|
## Hard Rule (Matt's)
|
|
|
|
> "Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead."
|
|
|
|
The `artifact_deduplicator.py` enforces this — FAIL verdict blocks the handoff.
|
|
|
|
## Workflow
|
|
|
|
```bash
|
|
# 1. Generate template tailored to focus
|
|
python ../skills/handoff/scripts/handoff_template_generator.py \
|
|
--next-focus "<focus from command argument>" \
|
|
--mktemp
|
|
|
|
# 2. Fill in the 5 sections from current conversation state
|
|
|
|
# 3. Pre-flight: dedup check
|
|
python ../skills/handoff/scripts/artifact_deduplicator.py path/to/draft.md
|
|
# CLEAN or WARN (with justified findings) → proceed
|
|
# FAIL → refactor; replace duplicated content with refs
|
|
|
|
# 4. Populate skills section
|
|
python ../skills/handoff/scripts/skill_recommender.py path/to/draft.md
|
|
# Use top recommendations for "Skills to use"
|
|
|
|
# 5. Share the file path. Next agent reads + acts.
|
|
```
|
|
|
|
## Tailoring Logic
|
|
|
|
| Focus argument keyword | Section emphasis |
|
|
|---|---|
|
|
| ship/deploy/PR | Deployment commands, checks, approvers, rollback |
|
|
| review/audit | Checklist, sensitive files, similar patterns |
|
|
| debug/fix/investigate | Symptom, repro steps, tried-already |
|
|
| design/plan/scope | Outcome, constraints, rejected alternatives |
|
|
| test/qa | Test plan, existing coverage, edge cases |
|
|
| (other) | Immediate action, blocker, files, open decisions |
|
|
|
|
## Length Target
|
|
|
|
50-100 lines. Anything longer probably duplicates an artifact.
|
|
|
|
## Related
|
|
|
|
- Agent: [`cs-handoff-author`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering/handoff/agents/cs-handoff-author.md)
|
|
- Skill: [`handoff`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering/handoff/skills/handoff/SKILL.md)
|
|
- Adjacent: `/cs:caveman`, `/cs:grill-me`, `/cs:write-a-skill`
|
|
|
|
---
|
|
|
|
**Version:** 1.0.0
|
|
**Derived:** Matt Pocock's handoff (MIT) + this repo's wrapper
|