tobihagemann/turbo / codex/skills/survey-patterns
survey-patterns
VerifiedSurvey the codebase for analogous features, reusable utilities, and existing patterns before a change. Use when the user asks to "survey patterns", "find existing patterns", or "find prior art".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.4 KB |
| references/pattern-surveyor.md | markdown | 6.8 KB |
SKILL.md
View on GitHub---
name: survey-patterns
description: "Survey the codebase for analogous features, reusable utilities, and existing patterns before a change. Use when the user asks to \"survey patterns\", \"find existing patterns\", or \"find prior art\"."
---
# Survey Patterns
Search the codebase for analogous features and reusable building blocks before planning a change, and read any source the task names outside this repo. Returns structured findings. Does not write code or plans.
## Step 1: Identify the Task
Determine what the change is about:
- If a task description was passed in, use it
- Otherwise, derive it from conversation context (the user's latest request)
State the task back in one sentence to confirm scope before searching.
## Step 2: Spawn Pattern Survey Sub-agent
Resolve the absolute path of this skill's directory, the directory of the `SKILL.md` loaded for this run, and use it as `<this skill's directory>` below.
Spawn a single sub-agent (inherited model defaults). Its prompt must direct it to treat the shared working tree and its git index as read-only and to survey by reading and reasoning. Its prompt must also direct it to search the repository with a tool that skips gitignored files, such as `git grep --untracked`, and to open or search a gitignored path only when its prompt or a file its prompt directs it to read names it, or when a dependency's installed source is needed to verify a claim, never one holding local configuration or credentials. HEAD stays where it is: read other refs with `git show <ref>:<path>` rather than `git checkout` or `git switch`. The sub-agent's prompt must include:
1. The confirmed task description from Step 1
2. An instruction to read `<this skill's directory>/references/pattern-surveyor.md` for survey guidelines, categories, and output format before searching
The sub-agent covers all three categories (Analogous Features, Reusable Utilities, Convention Anchors) in one sweep, reads any external source the task names, and returns a single structured report.
## Step 3: Output Findings
Output the sub-agent's report verbatim. Do not reformat or re-synthesize — `references/pattern-surveyor.md` specifies the exact output format the sub-agent produces.
Then call `update_plan` to mark this step completed and continue with the next step of the active workflow.
## Rules
- Do not write files.
- Do not propose implementation steps.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |