feat: implement agent-os standards system and feature planning tools
- Split CODING_GUIDELINES.md into 19 indexed standards files under .claude/standards/ - 9 from CODING_GUIDELINES (conventions, powershell, security, api, git, gururmm) - 10 from session log tribal knowledge (syncro, ssh, gitea, python, client, gururmm) - Add .claude/standards/index.yml for cheap relevance-based lookup - Add /inject-standards command: load targeted standards per task instead of full guidelines - Add /shape-spec command: pre-implementation spec for GuruRMM features (plan.md, shape.md, references.md, standards.md) with mandatory out-of-scope gate - Add docs/tech-stack.md and docs/mission.md for ClaudeTools API - Add projects/msp-tools/guru-rmm/docs/tech-stack.md and mission.md for GuruRMM - Update CLAUDE.md commands table with /inject-standards and /shape-spec Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
51
.claude/standards/context-lookup/grepai-first.md
Normal file
51
.claude/standards/context-lookup/grepai-first.md
Normal file
@@ -0,0 +1,51 @@
|
||||
---
|
||||
name: grepai-first
|
||||
description: Search with GrepAI or Grep before opening any file for context; Read only when full content is needed
|
||||
applies-to: all
|
||||
---
|
||||
|
||||
# Context Lookup — GrepAI First
|
||||
|
||||
Before reading any file for context, search with GrepAI or Grep. Only open a file when you need its full content for editing or line-by-line review.
|
||||
|
||||
## Lookup table
|
||||
|
||||
| Goal | Tool |
|
||||
|------|------|
|
||||
| Find where a function is defined | `grepai_search` or `Grep` |
|
||||
| Understand how a feature works | `grepai_search` |
|
||||
| Find all callers of a function | `grepai_trace_callers` |
|
||||
| Find what a function calls | `grepai_trace_callees` |
|
||||
| Full file content needed (edit, review) | `Read` |
|
||||
| Recent changes to a file | `git log`, then `Read` specific file |
|
||||
| "What did we do with X?" | `grepai_search` over session logs |
|
||||
| "How is Y configured?" | `grepai_search` before checking any specific file |
|
||||
|
||||
## Token cost rationale
|
||||
|
||||
Reading a 500-line file to find one function costs approximately 3,000 tokens. A targeted GrepAI or Grep search costs approximately 100 tokens and returns only the relevant lines. At scale, reading files for context without searching first wastes context window and increases latency.
|
||||
|
||||
Never open a large file to scan for context. Search first; read only if the search result is insufficient or if you need to edit the file.
|
||||
|
||||
## GrepAI specifics
|
||||
|
||||
- CLI: `D:/claudetools/grepai.exe search "query" --json -c -n 5`
|
||||
- MCP tools: `grepai_search` (primary), `grepai_trace_callers`, `grepai_trace_callees`
|
||||
- The GrepAI index covers session logs, skill files, and project docs with boosted relevance for `.claude/` content
|
||||
- The watcher (scheduled task "GrepAI Watcher - claudetools") keeps the index current automatically
|
||||
|
||||
## Common search queries
|
||||
|
||||
```bash
|
||||
# Find where a setting is configured
|
||||
grepai_search "vault_path"
|
||||
|
||||
# Understand how the Syncro skill handles billing
|
||||
grepai_search "timer_entry charge_timer"
|
||||
|
||||
# Find what we did with a specific client or feature
|
||||
grepai_search "Cascades DMARC"
|
||||
|
||||
# Locate a function definition
|
||||
Grep --pattern "fn collect_temps" --type rust
|
||||
```
|
||||
Reference in New Issue
Block a user