Purpose: Section-level lookup with file:line references for targeted reading.
Usage: Identify section → read with offset → minimal token consumption
CORE GUARDRAILS
AGENT_GUARDRAILS.md (docs/AGENT_GUARDRAILS.md)
| Section |
Line |
Offset |
| Applicability |
9 |
0 |
| Purpose |
27 |
18 |
| Four Laws of Agent Safety |
41 |
32 |
| Safety Protocols (Mandatory) |
53 |
44 |
| Pre-Execution Checklist |
55 |
46 |
| Git Safety Rules |
71 |
62 |
| Code Safety Rules |
84 |
75 |
| Test/Production Separation Rules |
97 |
88 |
| Guardrails |
112 |
103 |
| Halt Conditions |
114 |
105 |
| Forbidden Actions |
140 |
131 |
| Scope Boundaries |
194 |
185 |
| Quick Reference |
221 |
212 |
| Related Documents |
260 |
251 |
2026 UI/UX GAME DESIGN
2026_GAME_DESIGN.md (docs/game-design/2026_GAME_DESIGN.md)
| Section |
Line |
Offset |
| Purpose |
8 |
0 |
| Agent-GDUI-2026 Role Definition |
17 |
9 |
| Core Principles |
28 |
20 |
| Four Laws of Spatial Safety |
30 |
22 |
| Safety Protocols |
36 |
28 |
| Pre-Implementation Checklist |
38 |
30 |
| XR/VR Comfort Rules |
49 |
41 |
| Accessibility Requirements (WCAG 3.0+) |
61 |
53 |
| Performance Budgets |
73 |
65 |
| Dark Pattern Prevention |
84 |
76 |
| Platform-Specific Rules |
96 |
88 |
| Mobile (iOS/Android) |
98 |
90 |
| PC (Desktop/Web) |
105 |
97 |
| Console (Xbox/PlayStation/Switch) |
112 |
104 |
| XR (VR/AR/MR) |
119 |
111 |
| Halt Conditions |
127 |
119 |
| Language-Specific Patterns |
146 |
138 |
| TypeScript/React |
148 |
140 |
| Rust (Bevy Game Engine) |
158 |
150 |
| Go (HTMX Patterns) |
168 |
160 |
| Related Documents |
177 |
169 |
2026_UI_UX_STANDARD.md (docs/ui-ux/2026_UI_UX_STANDARD.md)
| Section |
Line |
Offset |
| Purpose |
8 |
0 |
| Agent-GDUI-2026 Capabilities |
17 |
9 |
| Core Components |
28 |
20 |
| Foundational Components |
30 |
22 |
| Advanced Components |
40 |
32 |
| Design Tokens |
50 |
42 |
| Color Palette |
52 |
44 |
| Typography Scale |
67 |
59 |
| Spacing Scale |
83 |
75 |
| Interaction States |
96 |
88 |
| State Requirements |
98 |
90 |
| Focus Indicator Standard |
109 |
101 |
| Animation Guidelines |
118 |
110 |
| Motion Principles |
120 |
112 |
| Motion Implementation |
130 |
122 |
| Responsive Breakpoints |
141 |
133 |
| Platform Adaptation |
143 |
135 |
| Responsive Pattern |
154 |
146 |
| Halt Conditions |
164 |
156 |
| Language-Specific Patterns |
183 |
175 |
| TypeScript/React |
185 |
177 |
| Rust (Leptos/Yew) |
196 |
188 |
| Go (HTMX) |
207 |
199 |
| Related Documents |
217 |
209 |
ACCESSIBILITY_GUIDE.md (docs/accessibility/ACCESSIBILITY_GUIDE.md)
| Section |
Line |
Offset |
| Purpose |
8 |
0 |
| WCAG 3.0 Conformance Levels |
19 |
11 |
| Agent-GDUI-2026 Role |
26 |
18 |
| Implementation Checklist |
36 |
28 |
| Perceptual Accessibility |
38 |
30 |
| Cognitive Accessibility |
50 |
42 |
| Physical Accessibility |
62 |
54 |
| Technical Implementation |
74 |
66 |
| Contrast Calculation |
76 |
68 |
| Focus Indicator |
91 |
83 |
| Screen Reader Support |
102 |
94 |
| Keyboard Navigation |
124 |
116 |
| Testing Methods |
137 |
129 |
| Automated Testing |
139 |
131 |
| Manual Testing |
149 |
141 |
| Halt Conditions |
158 |
150 |
| Language-Specific Patterns |
179 |
171 |
| TypeScript/React |
181 |
173 |
| Rust |
192 |
184 |
| Related Documents |
203 |
195 |
SPATIAL_COMPUTING_UI.md (docs/spatial/SPATIAL_COMPUTING_UI.md)
| Section |
Line |
Offset |
| Purpose |
8 |
0 |
| Agent-GDUI-2026 Spatial Capabilities |
17 |
9 |
| Spatial Safety Protocols |
28 |
20 |
| Comfort Zones |
30 |
22 |
| Latency Requirements |
39 |
31 |
| Vestibular Safety |
46 |
38 |
| UI Layout Patterns |
56 |
48 |
| VR Layout (Full Immersion) |
58 |
50 |
| AR Layout (Physical Overlay) |
78 |
70 |
| MR Layout (Bidirectional) |
90 |
82 |
| Depth Layering |
102 |
94 |
| Three-Layer Standard |
104 |
96 |
| Depth Implementation |
114 |
106 |
| Interaction Patterns |
125 |
117 |
| Hand Gesture Vocabulary |
127 |
119 |
| Gaze Interaction |
138 |
130 |
| Haptic Feedback Patterns |
146 |
138 |
| Accessibility in XR |
157 |
149 |
| Spatial Accessibility |
159 |
151 |
| Cognitive Accessibility in XR |
171 |
163 |
| Performance Budgets |
180 |
172 |
| Frame Rate Requirements |
182 |
174 |
| Async Reprojection |
192 |
184 |
| Halt Conditions |
202 |
194 |
| Language-Specific Patterns |
229 |
221 |
| TypeScript (OpenXR/WebXR) |
231 |
223 |
| Rust (XR frameworks) |
244 |
236 |
| Related Documents |
263 |
255 |
ETHICAL_ENGAGEMENT.md (docs/ethical/ETHICAL_ENGAGEMENT.md)
| Section |
Line |
Offset |
| Purpose |
8 |
0 |
| Agent-GDUI-2026 Ethical Review |
17 |
9 |
| Dark Pattern Taxonomy |
28 |
20 |
| Category 1: Deceptive Interfaces |
30 |
22 |
| Category 2: Coercive Interfaces |
40 |
32 |
| Category 3: Addictive Interfaces |
50 |
42 |
| Category 4: Data Exploitation |
60 |
52 |
| Ethical Design Principles |
70 |
62 |
| Principle 1: Transparency |
72 |
64 |
| Principle 2: Choice |
79 |
71 |
| Principle 3: Wellbeing |
86 |
78 |
| Principle 4: Respect |
93 |
85 |
| Implementation Checklist |
100 |
92 |
| Pre-Deployment Ethical Review |
102 |
94 |
| Technical Implementation |
115 |
107 |
| Ethical Middleware |
117 |
109 |
| Dark Pattern Detection |
135 |
127 |
| Cancellation Flow |
169 |
161 |
| Halt Conditions |
179 |
171 |
| Language-Specific Patterns |
200 |
192 |
| TypeScript (React Ethics) |
202 |
194 |
| Go (Ethical Engagement) |
216 |
208 |
| Related Documents |
232 |
224 |
WORKFLOW DOCUMENTATION
workflows/INDEX.md (docs/workflows/INDEX.md)
| Section |
Line |
Offset |
| Workflow Index |
1 |
0 |
COMMIT_WORKFLOW.md (docs/workflows/COMMIT_WORKFLOW.md)
| Section |
Line |
Offset |
| Commit Workflow |
1 |
0 |
TESTING_VALIDATION.md (docs/workflows/TESTING_VALIDATION.md)
| Section |
Line |
Offset |
| Testing Validation |
1 |
0 |
GIT_PUSH_PROCEDURES.md (docs/workflows/GIT_PUSH_PROCEDURES.md)
| Section |
Line |
Offset |
| Git Push Procedures |
1 |
0 |
STANDARDS DOCUMENTATION
standards/INDEX.md (docs/standards/INDEX.md)
| Section |
Line |
Offset |
| Standards Index |
1 |
0 |
TEST_PRODUCTION_SEPARATION.md (docs/standards/TEST_PRODUCTION_SEPARATION.md)
| Section |
Line |
Offset |
| Test/Production Separation |
1 |
0 |
MODULAR_DOCUMENTATION.md (docs/standards/MODULAR_DOCUMENTATION.md)
| Section |
Line |
Offset |
| Modular Documentation |
1 |
0 |
MCP SERVER
MCP_TOOLS_REFERENCE.md (docs/MCP_TOOLS_REFERENCE.md)
| Section |
Line |
Offset |
| MCP Tools Reference |
1 |
0 |
TEAM_TOOLS.md (docs/TEAM_TOOLS.md)
| Section |
Line |
Offset |
| Team Tools |
1 |
0 |
ARCHITECTURE_CLEAN_CQRS.md (docs/ARCHITECTURE_CLEAN_CQRS.md)
| Section |
Line |
Offset |
| Clean Architecture & CQRS |
1 |
0 |
AI TOOL INTEGRATION
CLCODE_INTEGRATION.md (docs/CLCODE_INTEGRATION.md)
| Section |
Line |
Offset |
| Claude Code Integration |
1 |
0 |
OPCODE_INTEGRATION.md (docs/OPCODE_INTEGRATION.md)
| Section |
Line |
Offset |
| OpenCode Integration |
1 |
0 |
CURSOR_INTEGRATION.md (docs/CURSOR_INTEGRATION.md)
| Section |
Line |
Offset |
| Cursor Integration |
1 |
0 |
WINDSURF_INTEGRATION.md (docs/WINDSURF_INTEGRATION.md)
| Section |
Line |
Offset |
| Windsurf Integration |
1 |
0 |
COPILOT_INTEGRATION.md (docs/COPILOT_INTEGRATION.md)
| Section |
Line |
Offset |
| GitHub Copilot Integration |
1 |
0 |
AGENTS_AND_SKILLS_SETUP.md (docs/AGENTS_AND_SKILLS_SETUP.md)
| Section |
Line |
Offset |
| Quick Start |
5 |
0 |
| Platform Comparison |
16 |
11 |
| Installation Methods |
28 |
23 |
| MCP Tool (Automated) |
30 |
25 |
| Python Script (CLI) |
51 |
46 |
| Manual Copy |
81 |
76 |
| Symlink (Live Updates) |
104 |
99 |
| Per-Platform Guides |
115 |
110 |
| Claude Code |
117 |
112 |
| Cursor |
165 |
160 |
| Windsurf |
209 |
204 |
| OpenCode |
238 |
233 |
| GitHub Copilot |
315 |
310 |
| Shared Prompts |
345 |
340 |
| MCP Tool Usage |
361 |
356 |
| Architecture Reference |
407 |
402 |
| Customization |
415 |
410 |
| Troubleshooting |
459 |
454 |
| References |
487 |
482 |
SHARED SKILL PROMPTS (skills/shared-prompts/)
| File |
Purpose |
| four-laws.md |
Four Laws of Agent Safety |
| halt-conditions.md |
When to stop and escalate |
| vibe-coding.md |
Vibe coding principles |
| error-recovery.md |
How to recover from failures |
| three-strikes.md |
Failure attempt tracking |
| production-first.md |
Production before test |
| scope-validation.md |
File scope authorization |
LANGUAGE-SPECIFIC EXAMPLES
| Language |
Directory |
README Location |
| Go |
examples/go/ |
examples/go/README.md |
| Java |
examples/java/ |
examples/java/README.md |
| Python |
examples/python/ |
examples/python/README.md |
| Ruby |
examples/ruby/ |
examples/ruby/README.md |
| Rust |
examples/rust/ |
examples/rust/README.md |
| TypeScript |
examples/typescript/ |
examples/typescript/README.md |
QUICK OFFSET USAGE
# Read specific section with offset
# Example: Read Halt Conditions from 2026_GAME_DESIGN.md
read docs/game-design/2026_GAME_DESIGN.md --offset 127 --limit 20
# Example: Read Accessibility Requirements from ACCESSIBILITY_GUIDE.md
read docs/accessibility/ACCESSIBILITY_GUIDE.md --offset 38 --limit 20
# Example: Read Dark Pattern Prevention from ETHICAL_ENGAGEMENT.md
read docs/ethical/ETHICAL_ENGAGEMENT.md --offset 84 --limit 20
Last Updated: 2026-05-09
Document Owner: Documentation Team
Token Savings: 60-80% vs full document reads