Documentation System
Documentation System
A system for writing clear, maintainable documentation optimized for both humans and AI navigation.
Core Philosophy
- Document logic, not syntax - Explain how things work together, not what's obvious from code
- Progressive disclosure - Overview first, details on demand
- AI-navigable - Clear structure so AI can find and update the right docs
- Minimal but complete - Include what's needed, nothing more
Folder Structure
Documentation lives in docs/ with three top-level folders:
docs/
├── index.md # Entry point: what is this codebase, how to navigate
├── system/ # How the system works (capabilities, concepts, flows)
More from hhopkins95/ai-systems
opencode sdk development
This skill should be used when the user asks to "create an OpenCode tool", "build an OpenCode plugin", "write a custom tool for OpenCode", "use @opencode-ai/sdk", "use @opencode-ai/plugin", "integrate with OpenCode", "create OpenCode hooks", "define tool schema", "use tool.schema", "work with OpenCode sessions", or needs guidance on OpenCode SDK patterns, plugin development, or custom tool creation.
31backend setup
This skill should be used when the user asks to "create an agent runtime server", "set up agent runtime backend", "configure Modal sandbox", "implement PersistenceAdapter", "start WebSocket server", "create REST API for agents", or needs to build a Node.js backend using @hhopkins/agent-runtime.
1project tracking
System for tracking work across AI sessions. Use when starting or ending work sessions, managing initiatives, capturing ideas or todos, or when needing to understand what work is in progress. Handles knowledge transfer between sessions.
1agent design
This skill should be used when the user asks to "configure agent profile", "add skills to agent", "set up MCP servers", "configure agent tools", "write system prompt", "create agent workflow", "define agent commands", "add subagents", or needs to define what capabilities an agent has and how to orchestrate complex workflows in the runtime.
1agent design 2
This skill should be used when the user asks to "configure agent profile", "add skills to agent", "set up MCP servers", "configure agent tools", "write system prompt", "create agent workflow", "define agent commands", "add subagents", or needs to define what capabilities an agent has and how to orchestrate complex workflows in the runtime.
1agent runtime overview
This skill should be used when the user asks "what is agent-runtime", "why use agent-runtime", "what does this repo do", "agent runtime architecture", "how does agent-runtime work", or needs to understand the purpose, value proposition, and high-level architecture of the @hhopkins/agent-runtime monorepo.
1