@codihaus/claude-skills 1.6.10 → 1.6.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codihaus/claude-skills",
-  "version": "1.6.10",
+  "version": "1.6.11",
   "description": "Claude Code skills for software development workflow",
   "main": "src/index.js",
   "bin": {

package/skills/_registry.md

@@ -22,9 +22,10 @@ Central registry of all available skills. Reference this to suggest relevant ski
 | Skill | Purpose | Called By |
 |-------|---------|-----------|
 | `/utils/diagram` | Create/validate Mermaid diagrams | `/dev-scout`, `/dev-specs`, `/dev-arch` |
-| `/utils/docs-graph` | View documentation relationships | `/debrief`, `/dev-specs`, `/dev-arch` |
 | `/utils/gemini` | Large context scanning (1M tokens) | `/dev-scout` for large codebases |
 
+**Note:** Documentation graph (`docs-graph.json`) is automatically updated by Claude Code hook, not a skill.
+
 ## Skill Flow
 
 ```
@@ -66,9 +67,6 @@ Need to document what was built?
 
 Need to visualize something?
     → /utils/diagram (usually called by other skills)
-
-Need to see doc relationships?
-    → /utils/docs-graph (usually called by other skills)
 ```
 
 ## Trigger Phrases
@@ -86,7 +84,6 @@ When user says... → Suggest skill
 | "review my code", "check this PR" | `/dev-review` |
 | "what was built", "summarize changes", "document implementation" | `/dev-changelog` |
 | "create diagram", "architecture diagram", "flow chart" | `/utils/diagram` |
-| "what links to this", "doc relationships" | `/utils/docs-graph` |
 
 ## Cross-Skill Suggestions
 
@@ -147,11 +144,6 @@ During each skill, consider suggesting:
 - Called by other skills, not typically invoked directly
 - Used for: architecture diagrams, flow charts, ERD
 
-### /utils/docs-graph
-- Utility skill for documentation relationships
-- Called by other skills to understand dependencies
-- Auto-updated by Claude Code hooks
-
 ## Quality Attributes
 
 All skills reference `skills/_quality-attributes.md` for their respective level:

package/skills/debrief/SKILL.md

@@ -10,7 +10,7 @@ version: 3.9.0
 > - **Before**: Use `/dev-scout` if existing codebase
 > - **During**: Calls `/dev-arch` to validate architecture feasibility
 > - **After**: Use `/dev-specs` for implementation plans
-> - **Utils**: `/utils/docs-graph` for relationships
+> - **Auto**: `docs-graph.json` updated by hook for relationships
 
 Create and maintain the unified BRD for a project. Handles initial requirements and feature additions.
 

package/skills/utils/docs-graph/SKILL.md

@@ -1,177 +0,0 @@
----
-name: utils/docs-graph
-description: View and query the documentation knowledge graph
-version: 1.3.0
----
-
-# /utils/docs-graph - Documentation Graph Viewer
-
-> **Skill Awareness**: See `skills/_registry.md` for all available skills.
-> - **Auto-updated**: By Claude Code hook on Write/Edit to plans/
-> - **Called by**: `/dev-specs`, `/debrief`, `/dev-arch` for relationships
-> - **Note**: Utility skill, typically called by other skills
-
-View and query relationships between planning documents.
-
-## When to Use
-
-- See overview of all plans and their relationships
-- Find related documents before making changes
-- Check impact of changes (what links to this?)
-- Verify links are valid
-
-## Usage
-
-```
-/utils/docs-graph                    # Show graph summary
-/utils/docs-graph auth               # Show nodes related to "auth"
-/utils/docs-graph --check            # Verify all links resolve
-```
-
-## How It Works
-
-**Automatic Updates:**
-- PostToolUse hook triggers on Write/Edit to `plans/`
-- Regenerates entire graph from all files in `plans/`
-- Updates `plans/docs-graph.json` and `plans/docs-graph.md`
-- Timeout: 3 minutes
-
-**Graph Files:**
-```
-plans/
-├── docs-graph.json    # Machine-readable graph data
-└── docs-graph.md      # Mermaid visualization
-```
-
-## Expected Outcome
-
-**Summary mode (default):**
-- Node count by type
-- Edge count
-- Mermaid diagram from docs-graph.md
-
-**Query mode (with argument like "auth"):**
-- Matching nodes
-- Incoming links (what references this)
-- Outgoing links (what this references)
-
-**Check mode (--check):**
-- Report broken links
-- Suggest fixes
-
-## Wikilink Convention
-
-Documents use `[[wikilinks]]` to reference each other:
-
-```markdown
-# UC-AUTH-001: Login
-
-> **Feature**: [[feature-auth]]
-> **Related**: [[uc-auth-002]], [[uc-auth-003]]
-> **Spec**: [[spec-auth-001]]
-```
-
-**Link ID format:**
-- Use cases: `[[uc-auth-001]]` (lowercase, no slug)
-- Features: `[[feature-auth]]`
-- Specs: `[[spec-auth-001]]`
-- Change requests: `[[cr-001]]`
-
-## Node Types
-
-| Type | Source | Shape (Mermaid) |
-|------|--------|-----------------|
-| brd | `brd/README.md` | Stadium `[[]]` |
-| use-case | `brd/use-cases/**/*.md` | Rectangle `[]` |
-| change-request | `brd/changes/*.md` | Hexagon `{{}}` |
-| feature | `features/*/README.md` | Pill `([])` |
-| spec | `features/*/specs/**/*.md` | Parallelogram `[//]` |
-| scout | `**/scout.md` | Cylinder `[()]` |
-
-## Example Output
-
-### Summary
-
-```
-Documentation Graph Summary
-===========================
-Nodes: 12 | Edges: 18
-
-By Type:
-  use-case: 5
-  feature: 2
-  spec: 4
-  brd: 1
-
-View full graph: plans/docs-graph.md
-```
-
-### Query: `/utils/docs-graph auth`
-
-```
-Nodes matching "auth": 4
-
-uc-auth-001 (use-case) - Login
-  ← feature-auth, spec-auth-001
-  → feature-auth
-
-uc-auth-002 (use-case) - Signup
-  ← feature-auth
-  → uc-auth-001, feature-auth
-
-feature-auth (feature) - Authentication
-  ← uc-auth-001, uc-auth-002, uc-auth-003
-  → (none)
-
-spec-auth-001 (spec) - Login Spec
-  ← (none)
-  → uc-auth-001
-```
-
-### Check: `/utils/docs-graph --check`
-
-```
-Link Check Results
-==================
-✓ 16 valid links
-✗ 2 broken links
-
-Broken:
-  plans/brd/use-cases/auth/UC-AUTH-001-login.md:5
-    [[uc-auth-004]] - node not found
-
-  plans/features/auth/specs/UC-AUTH-001/README.md:12
-    [[feature-billing]] - node not found
-
-Suggestions:
-  - uc-auth-004: Did you mean uc-auth-003?
-  - feature-billing: Create plans/features/billing/README.md
-```
-
-## Tools Used
-
-| Tool | Purpose |
-|------|---------|
-| `Bash` | Run graph.py script |
-| `Read` | Read docs-graph.json, docs-graph.md |
-| `Glob` | Find plan files |
-
-## Integration
-
-| Skill | Relationship |
-|-------|--------------|
-| `/debrief` | Creates use cases with wikilinks |
-| `/dev-specs` | Creates specs linking to use cases |
-| `/dev-scout` | Creates scout.md for features |
-
-## Troubleshooting
-
-**Graph not updating:**
-- Check hook is in `.claude/settings.local.json`
-- Verify `jq` is installed
-- Run `/utils/docs-graph --regenerate` to force update
-
-**Broken links:**
-- Run `/utils/docs-graph --check` to find issues
-- Update wikilinks to match node IDs
-- Node IDs are lowercase, no slug (e.g., `uc-auth-001` not `UC-AUTH-001-login`)