Skip to content

static-var/Keystone / skills/context-survey

context-survey

Unverified

Project context survey for repository reconnaissance or project decisions that require evidence from existing code, project documentation, or project-specific external sources before planning or changing the project.

Context Survey

Core principle

Context Survey is evidence gathering before action. Inspect available material first, preserve source quality, separate facts from assumptions, and stay read-only unless the user explicitly asks for a durable context-survey artifact.

Load when

Load when a software or product project needs:

  • repository reconnaissance or understanding as the requested project outcome;
  • evidence from existing code, tests, configuration, history, or project documentation;
  • project-specific external documentation, standards, issues, market examples, or APIs;
  • synthesis or validation of project evidence before another Keystone phase.

Entry fit

An explicit invocation selects the full Context Survey behavior.

A Keystone handoff selects the full skill for project-bound repository understanding or evidence needed for a project decision or change.

For automatic entry, the prompt's subject must be project-bound. Load the full skill when repository understanding or reconnaissance is the requested outcome, or when this evidence contract materially improves a project decision or change. The current directory alone does not establish project scope.

For automatic routing of standalone public search, general research, ordinary explanation, or summarization unrelated to a project, use the direct research/answering path and return the requested result without Keystone gates.

Not for

  • Implementing, refactoring, editing, or fixing code.
  • Shaping product direction beyond evidence-backed options.
  • Broad tooling risk audits; use project-audit.
  • Root-cause repair of a failure; use root-cause-analysis after initial context.
  • Guessing when evidence can be inspected.

Outcome contract

Deliver a context-survey brief that states:

  • question or decision being supported;
  • sources inspected, with file paths, commands, URLs, or other citations;
  • source-quality notes (primary vs secondary, current vs stale, authoritative vs anecdotal);
  • findings separated from assumptions and unknowns;
  • confidence level and why;
  • recommended next module, or none if no Keystone handoff is warranted.

Modes

  • Repository read: inspect files, history, configs, tests, docs, and existing behavior. Prefer primary project evidence.
  • External context-survey: compare outside documentation, standards, issues, market examples, or APIs. Cite URLs and note recency.
  • Synthesis: combine several sources into a decision-ready summary with tradeoffs and confidence.
  • Discovery scout: map a large unknown area without drawing strong conclusions until evidence is sampled.

Process

  1. Restate the context-survey question or requested repository reconnaissance outcome, and the downstream decision when applicable.
  2. Inspect before asking: search/read the repo, docs, logs, or provided sources before requesting more context.
  3. Prefer primary evidence: source code, tests, product docs, official docs, reproducible commands, direct user-provided material.
  4. Track citations as you go. Every important claim should point to evidence or be labeled as an assumption.
  5. Evaluate source quality: age, authority, completeness, bias, and whether evidence is direct or inferred.
  6. Compare alternatives when relevant, including costs, risks, constraints, and implications of taking no action.
  7. State unknowns explicitly. Do not fill gaps with confident-sounding speculation.
  8. Recommend the smallest next step: product-planning, root-cause-analysis, project-audit, task-creation, implementation, change-review, or stop.

Subagents and reasoning

Use read-only subagents when the search space is large or evidence can be gathered independently. Use lightweight analysis for narrow file summaries and deeper analysis when findings affect architecture, security, safety, release decisions, legal/market claims, or irreversible product direction. When delegation is available, encode required evidence depth and risk standard in the prompt. Subagents must remain read-only unless the user requested an artifact.

Hard rules

  • No mutation by default: do not edit files, run formatters, or alter state except harmless read-only commands.
  • Durable artifact exception: if the user requests a context-survey artifact, confirm the path and scope before writing; hand off to implementation when the artifact changes product/code behavior or touches broader project structure.
  • Cite evidence for material claims; if evidence is unavailable, say so.
  • Distinguish facts, interpretations, assumptions, and recommendations.
  • Do not ask for information that can be inspected first.
  • Do not present search results or model knowledge as authoritative without source-quality caveats.

Failure modes

  • Context theater: long summaries without citations or decision relevance.
  • Source laundering: treating blogs, stale docs, or guesses as facts.
  • Premature shaping: deciding product behavior before evidence is clear.
  • Mutation creep: “just fixing” or rewriting while context-surveying.
  • Hidden uncertainty: omitting confidence, unknowns, or contradictory evidence.

Worked example

Good context-survey finding: “Official Stripe docs show idempotency keys apply per unique key and preserve the first result, including failures; this means retrying payment capture should reuse the original key, not generate a new one. Confidence: High — primary docs, current page.”

Bad context-survey finding: “Stripe probably handles retries safely, so we can just retry the request.”

Output format

## Context Survey brief
Question: ...

### Evidence inspected
- `path/or/source`: what it shows, quality note

### Findings
- Fact — citation
- Interpretation — citation + reasoning

### Assumptions / unknowns
- ...

### Options or implications
- ...

### Confidence
High/Medium/Low — why

### Recommended next step
Module or `none`, with rationale

### Checkpoint
Use the required fields from `../_shared/gates/checkpoint.md`.

rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 196kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 196kUpdated Claude CodeCodexVerifiedInstall