survey

Analyze a codebase from multiple agent perspectives to generate beads and mermaid diagrams.

2|1|Updated Oct 3, 2025
One-click install
npx skills add https://github.com/jamestexas/agents --skill survey-jamestexas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: survey
Source: https://github.com/jamestexas/agents/tree/main/skills/survey
Command: npx skills add https://github.com/jamestexas/agents --skill survey-jamestexas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It enables teams to systematically analyze a codebase from multiple agent perspectives, surfacing the same repository as distinct, comparable beads and mermaid diagrams to expose disagreements and architectural concerns.

Core Features & Use Cases

  • Multi-perspective analysis: dev/prod/staging/feature/pm lenses examine the same codebase at different zoom levels to produce beads and a disagreement matrix.
  • Bead-based findings: Each perspective tags discoveries as beads with contextual attributes for traceability.
  • Mermaid diagram generation: Translates code structure into mermaid diagrams to visualize dependencies and architecture.
  • Collaboration facilitation: Produces a disagreement matrix to highlight cross-perspective conflicts for remediation.

Quick Start

Run /survey in your repository to generate beads and mermaid diagrams from your codebase.

Frequently Asked Questions about survey

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a codebase from multiple perspectives to find architectural risks?

Multi-perspective codebase analysis applies dev, prod, staging, feature, and PM lenses to examine the same repository, surfacing architectural risks and design inconsistencies through cross-perspective validation. It generates tagged beads and a disagreement matrix to highlight conflicts for remediation.

What is the best way to visualize codebase structure and dependencies using mermaid diagrams?

Generating mermaid diagrams from code structure translates repository dependencies and architecture into visual representations. It systematically examines the codebase through multiple agent perspectives to produce accurate diagrams that expose structural relationships and design inconsistencies.

How do I identify testing gaps and design inconsistencies across a repository?

Cross-perspective validation identifies testing gaps and design inconsistencies by examining the codebase through multiple agent lenses. It tags discoveries as beads with contextual attributes for traceability and compiles a disagreement matrix to highlight conflicting findings for remediation.

Can I use a structured skill to coordinate code discovery and generate a disagreement matrix?

A structured frontmatter-driven skill coordinates discovery, perspective-specific analysis, and final diagram generation to produce a disagreement matrix. It applies multiple agent perspectives to the same repository to surface conflicts and architectural concerns between different analytical lenses.

How do I generate traceable findings from a codebase analysis for team collaboration?

Bead-based findings tag codebase discoveries as beads with contextual attributes for traceability. Multi-perspective analysis produces these beads alongside mermaid diagrams and a disagreement matrix, enabling teams to systematically compare distinct perspectives and highlight architectural concerns for collaboration.