ctx

ctx (Context Hydration)

Category: Context Management

Usage

/​ctx <doc-reference>

Arguments

• <doc-reference>: Required - Document identifier or path. Accepts:
  • Document IDs: PRD-001, FRD-042, TS-0045, RFC-0042
  • Partial names: user-auth, payment-gateway
  • File paths: ./​product-docs/​prds/​active/​user-auth-prd.md

Execution Instructions for Claude Code

When this command is run, Claude Code should:

1. Identify Document Type and Location

   Search order by ID prefix:

   Prefix	Type	Search Locations
   PRD-	Product PRD	product-docs/​prds/
   FRD-	Feature PRD	product-docs/​prds/
   TS-	Tech Spec	tech-specs/
   RFC-	RFC	rfcs/

   If no prefix, search all locations for partial name match.

2. Search for Document

   # Search patterns by type
   PRD/​FRD: product-docs/​prds/​**/​*<query>*.md
   Tech Spec: tech-specs/​**/​*<query>*.md
   RFC: rfcs/​**/​*<query>*.md
   

3. Handle Multiple Matches

   If multiple documents match, display options:

   Multiple documents match "auth":
   
   1. PRD-001-user-authentication-prd.md (PRD)
   2. FRD-015-oauth-integration-frd.md (FRD)
   3. TS-0044-auth-implementation.md (Tech Spec)
   4. RFC-0043-auth-redesign.md (RFC)
   
   Which document to load? [1-4]
   

4. Read and Present Document

   Read the full document content and present with context header:

   ═══════════════════════════════════════════════════════════
   📄 CONTEXT LOADED: PRD-001 - User Authentication System
   ═══════════════════════════════════════════════════════════
   
   Type:     Product PRD
   Status:   ACTIVE
   Version:  1.2
   Location: product-docs/​prds/​active/​PRD-001-user-authentication-prd.md
   
   Related Documents:
   - Tech Spec: TS-0044-auth-implementation.md
   - Tasks: tasks/​PRD-001-tasks.md
   
   ───────────────────────────────────────────────────────────
   
   [Full document content here]
   
   ═══════════════════════════════════════════════════════════
   Context loaded. Ready to work on this document.
   ═══════════════════════════════════════════════════════════
   

5. Extract Related Documents

   Parse the loaded document for references to other documents:

   • Links to RFCs, Tech Specs, PRDs, FRDs
   • Task file references
   • Dependency references

   Offer to load related documents:

   💡 Related documents found:
      - RFC-0043 (linked)
      - TS-0044 (implementation spec)
   
   Load related? [y/​N]
   

Loading Multiple Documents

Support loading multiple documents at once:

# Load multiple by ID
/​ctx PRD-001 RFC-0043

# Load all related to a PRD
/​ctx PRD-001 --related

# Load PRD with its tech spec and tasks
/​ctx PRD-001 --full

Options

Output Modes

Default (Full Content)

Loads complete document content into context.

Summary Mode (--summary)

📄 PRD-001: User Authentication System
   Status: ACTIVE | Version: 1.2 | Progress: 67%

   Overview:
   Implement secure user authentication with OAuth 2.0 support,
   including social login providers and MFA capabilities.

   Key Sections:
   - User Stories (12 items)
   - Technical Requirements (8 items)
   - Success Metrics (5 KPIs)

   Use '/​ctx PRD-001' for full content.

Document Type Detection

Infer document type from:

1. Filename patterns

   • *-prd.md → Product PRD
   • *-frd.md → Feature PRD
   • TS-* → Tech Spec
   • RFC-* → RFC

2. Directory location

   • product-docs/​prds/ → PRD/​FRD
   • tech-specs/ → Tech Spec
   • rfcs/ → RFC

3. Frontmatter type field

   type: product-prd | feature-frd | tech-spec | rfc
   

Error Handling

• Document not found: Show search suggestions

  Document "auth-prd" not found.
  
  Did you mean:
  - user-authentication-prd.md
  - oauth-auth-frd.md
  
  Or search all docs: /​list-prds, /​list-tech-specs, /​list-rfcs
  

• Invalid path: Suggest correct format

• Empty document: Warn and show metadata only

Examples

# Load by document ID
/​ctx PRD-001
/​ctx RFC-0043
/​ctx TS-0044

# Load by partial name
/​ctx user-auth
/​ctx payment-gateway

# Load by path
/​ctx ./​product-docs/​prds/​active/​user-auth-prd.md

# Load with related documents
/​ctx PRD-001 --related

# Load full context (PRD + tech spec + tasks)
/​ctx PRD-001 --full

# Quick overview only
/​ctx PRD-001 --summary

# Load multiple documents
/​ctx PRD-001 RFC-0043 TS-0044

Integration Tips

1. After loading context: Ready to answer questions, implement tasks, or review the document
2. Combine with task-focus: Load context then focus on specific task
3. Use summary mode: Quick reference without full context load
4. Chain with other commands: /​ctx PRD-001 && /​generate-tasks

Implementation Notes for Claude Code

1. Efficient Search: Use glob patterns, don't read files until match confirmed
2. Cache Metadata: Parse frontmatter first for quick filtering
3. Fuzzy Matching: Support partial names and common abbreviations
4. Context Size: Warn if document is very large (>2000 lines)
5. Related Discovery: Parse document content for cross-references