trace
SolidTrace design decisions and concepts through session history, handoffs, and git. Triggers: "trace decision", "how did we decide", "where did this come from", "design provenance", "decision history".
Code & Development 457 stars
44 forks Updated 2 days ago Apache-2.0
Install
Quality Score: 91/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Trace Skill
> **Quick Ref:** Trace design decisions through CASS sessions, handoffs, git, and artifacts. Output: `.agents/research/YYYY-MM-DD-trace-*.md`
**YOU MUST EXECUTE THIS WORKFLOW. Do not just describe it.**
## When to Use
- Trace HOW architectural decisions evolved
- Find WHEN a concept was introduced
- Understand WHY something was designed a certain way
- Build provenance chain for design decisions
For knowledge artifact lineage (learnings, patterns, tiers), use `$provenance` instead.
**CLI dependencies:** cass (session search). If cass is unavailable, skip transcript search and rely on git log, handoff docs, and `.agents/` artifacts for decision tracing.
## Execution Steps
Given `$trace <concept>`:
### Step 1: Classify Target Type
Determine what kind of provenance to trace:
```
IF target is a file path (contains "/" or "."):
→ Use $provenance (artifact lineage)
IF target is a git ref (sha, branch, tag):
→ Use git-based tracing (Step 2b)
ELSE (keyword/concept):
→ Use design decision tracing (Step 2a)
```
### Step 2a: Design Decision Tracing (Concepts)
Launch 4 parallel search agents (CASS, Handoff, Git, Research) and wait for all to complete.
**Backend:** Agents use `spawn_agent` or `codex exec` for parallel exploration. See `../shared/SKILL.md` ("Backend Detection") for the shared contract.
Read `references/discovery-patterns.md` for agent definitions and prompts.
### Step 2b: Git-Based Tracing (Commits/Refs)
Read `references/discovery-pat...
Details
- Author
- boshu2
- Repository
- boshu2/agentops
- Created
- 1 years ago
- Last Updated
- 2 days ago
- Language
- Go
- License
- Apache-2.0
Bundled in these plugins
Similar Skills
Semantically similar based on skill content — not just same category
Code & Development Listed
trace
Trace design decisions and concepts through session history, handoffs, and git. Triggers: "trace decision", "how did we decide", "where did this come from", "design provenance", "decision history".
67 Updated 8 months ago
diegosouzapw AI & Automation Featured
trace
Evidence-driven tracing lane that orchestrates competing tracer hypotheses in Claude built-in team mode
40,923 Updated today
Yeachan-Heo AI & Automation Listed
trace
Dispatch trace subagent to investigate unknown issues — reproduces, traces, and reports root cause for fix handoff.
354 Updated today
automagik-dev