Architectural Grounding (Large File Discovery)

Category: Testing & Security | Uploader: hackafterdark | Downloads: 0 | Version: v1.0（Latest）

Safely explores and categorizes large entry-point files (>300 lines) without consuming massive context tokens.

Changelog: Source: GitHub https://github.com/hackafterdark/context-sherpa

Directory Structure

Current level: .agents/skills/architectural-grounding/

📄 SKILL.md 1.2 KB

SKILL.md

---
id: architectural-grounding
name: Architectural Grounding (Large File Discovery)
description: Safely explores and categorizes large entry-point files (>300 lines) without consuming massive context tokens.
tools_used: [list_symbols_in_file, summarize_code_intent, search_definitions]
trigger_conditions: [Assigned to a task in a file > 300 lines, exploring "App" or "Server" structs]
---

# Skill: Architectural Grounding

**Goal:** Understand the responsibility of a complex file without reading the raw source.

## Execution Pattern

1. **Metadata Triage:** If a file is known to be large (e.g., `app.go`, `main.go`, `server.go`), call `list_symbols_in_file` with `distill: true` immediately.
2. **Component Isolation:** Identify the 2-3 specific methods or structs in the distilled summary that are relevant to the query.
3. **Symbolic Zoom:** Call `search_definitions` or `get_symbol_map` on those specific components to find their definitions.
4. **Surgical Read:** ONLY call `read_file` or `view_file` for the specific line ranges identified in step 3. NEVER read more than 100 lines at once.

## Success Metric
The agent should be able to explain the "Flow" of a feature (like Database Init) while having read fewer than 15% of the total lines in the file.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

Architectural Grounding (Large File Discovery)

Directory Structure

SKILL.md

Report

Notice