feat(agents): add link and unlink commands to AGENTS.md for spec relationship management

Author: Marvin Zhang

docs-site

@@ -26,6 +26,8 @@ If you have LeanSpec MCP tools available, **ALWAYS use them**:
 | View a spec | `view` | Full content with formatting |
 | Create new spec | `create` | Auto-sequences, proper structure |
 | Update spec | `update` | Validates transitions, timestamps |
+| Link specs | `link` | Add relationships (depends_on, related) |
+| Unlink specs | `unlink` | Remove relationships |
 | Check dependencies | `deps` | Visual dependency graph |
 
 **Why MCP over CLI?**
@@ -44,6 +46,8 @@ lean-spec list               # See all specs
 lean-spec search "query"     # Find relevant specs
 lean-spec create <name>      # Create new spec
 lean-spec update <spec> --status <status>  # Update status
+lean-spec link <spec> --related <other>    # Add relationships
+lean-spec unlink <spec> --related <other>  # Remove relationships
 lean-spec deps <spec>        # Show dependencies
 ```
 

packages/cli/templates/detailed/AGENTS.md

@@ -26,6 +26,8 @@ If you have LeanSpec MCP tools available, **ALWAYS use them**:
 | View a spec | `view` | Full content with formatting |
 | Create new spec | `create` | Auto-sequences, proper structure |
 | Update spec | `update` | Validates transitions, timestamps |
+| Link specs | `link` | Add relationships (depends_on, related) |
+| Unlink specs | `unlink` | Remove relationships |
 | Check dependencies | `deps` | Visual dependency graph |
 
 **Why MCP over CLI?**
@@ -44,6 +46,8 @@ lean-spec list               # See all specs
 lean-spec search "query"     # Find relevant specs
 lean-spec create <name>      # Create new spec
 lean-spec update <spec> --status <status>  # Update status
+lean-spec link <spec> --related <other>    # Add relationships
+lean-spec unlink <spec> --related <other>  # Remove relationships
 lean-spec deps <spec>        # Show dependencies
 ```
 

packages/cli/templates/standard/AGENTS.md

@@ -8,14 +8,16 @@ tags:
   - v0.2
 priority: high
 created_at: '2025-11-10T05:35:31.293Z'
-updated_at: '2025-11-10T06:48:06.343Z'
+updated_at: '2025-11-28T01:50:23.546Z'
 transitions:
   - status: in-progress
     at: '2025-11-10T06:39:58.417Z'
   - status: complete
     at: '2025-11-10T06:48:06.343Z'
 completed_at: '2025-11-10T06:48:06.343Z'
 completed: '2025-11-10'
+related:
+  - 128-constant-time-migration
 ---
 
 # Migration from Existing SDD Tools

specs/063-migration-from-existing-tools/README.md

@@ -8,9 +8,11 @@ tags:
   - performance
 priority: high
 created_at: '2025-11-28T01:21:44.679Z'
-updated_at: '2025-11-28T01:41:34.566Z'
+updated_at: '2025-11-28T01:50:23.783Z'
 related:
   - 047-git-backfill-timestamps
+  - 063-migration-from-existing-tools
+  - 129-mcp-link-tool
 transitions:
   - status: in-progress
     at: '2025-11-28T01:37:15.462Z'

specs/128-constant-time-migration/README.md

@@ -10,7 +10,8 @@ priority: high
 created_at: '2025-11-28T01:27:53.890Z'
 related:
   - 085-cli-relationship-commands
-updated_at: '2025-11-28T01:41:34.563Z'
+  - 128-constant-time-migration
+updated_at: '2025-11-28T01:50:23.786Z'
 transitions:
   - status: in-progress
     at: '2025-11-28T01:37:15.477Z'