moai-workflow-jit-docs

name	moai-workflow-jit-docs
description	Enhanced Just-In-Time document loading system that intelligently discovers, loads, and caches relevant documentation based on user intent and project context. Use when users need specific documentation, when working with new technologies, when answering domain-specific questions, or when context indicates documentation gaps.
license	Apache-2.0
compatibility	Designed for Claude Code
allowed-tools	Read Grep Glob WebFetch WebSearch mcp__context7__resolve-library-id mcp__context7__get-library-docs
user-invocable	false
metadata	{"version":"3.0.0","category":"workflow","status":"active","updated":"2026-01-08","modularized":"false","tags":"workflow, documentation, jit-loading, context-aware, caching, discovery"}
progressive_disclosure	{"enabled":true,"level1_tokens":100,"level2_tokens":5000}
triggers	{"keywords":["documentation","docs","API reference","how to","implement","best practices","technology guide","framework documentation"],"phases":["plan","run","sync"],"agents":["manager-docs","manager-spec","expert-backend","expert-frontend"]}

Quick Reference (30 seconds)

Purpose: Load relevant documentation on-demand based on user intent and context.

Primary Tools:

• WebSearch: Find latest documentation and resources online
• WebFetch: Retrieve specific documentation pages
• Context7 MCP: Access official library documentation (when available)
• Read, Grep, Glob: Search local project documentation

Trigger Patterns:

• User asks specific technical questions
• Technology keywords detected in conversation
• Domain expertise required for task completion
• Implementation guidance needed

Implementation Guide

Intent Detection

The system recognizes documentation needs through several patterns:

Question-Based Triggers:

• When users ask specific implementation questions (e.g., "how do I implement JWT authentication?")
• When users seek best practices or optimization guidance
• When troubleshooting questions arise

Technology-Specific Triggers:

• Detection of framework names: FastAPI, React, PostgreSQL, Docker, Kubernetes
• Detection of library names: pytest, TypeScript, GraphQL, Redis
• Detection of tool names: npm, pip, cargo, maven

Domain-Specific Triggers:

• Authentication and authorization topics
• Database and data modeling discussions
• Performance optimization inquiries
• Security-related questions

Pattern-Based Triggers:

• Implementation requests: "implement", "create", "build"
• Architecture discussions: "design", "structure", "pattern"
• Troubleshooting: "debug", "fix", "error", "not working"

Documentation Sources

The system retrieves documentation from multiple sources in priority order:

Local Project Documentation (Highest Priority):

• Check .moai/docs/ for project-specific documentation
• Check .moai/specs/ for requirements and specifications
• Check README.md for project overview
• Check docs/ directory for comprehensive documentation

Official Documentation Sources:

• Use WebFetch to retrieve official framework documentation
• Use Context7 MCP tools when available for library documentation
• Access technology-specific official websites

Community Resources:

• Use WebSearch to find high-quality tutorials
• Search for Stack Overflow solutions with high vote counts