survey

Map codebase architecture and detect greenfield or brownfield status.

89|32|Updated May 28, 2026

Search Tags:#project setup #software architecture #continuous delivery #codebase mapping #architecture discovery

Ready to run

npx skills add https://github.com/genkovich/sdd --skill survey-genkovich

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: survey
Source: https://github.com/genkovich/sdd/tree/main/skills/survey
Command: npx skills add https://github.com/genkovich/sdd --skill survey-genkovich

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The survey Skill helps developers and architects map and set up the architecture for new projects or assess and update the architecture of existing codebases, streamlining the initial setup and maintenance processes.

Core Features & Use Cases

Architecture Mapping: Automates the process of scanning an existing codebase to identify language, frameworks, data stores, and inter-module communication.
Greenfield Setup: Guides the user through setting up a new project with default conventions, stack selection, and foundational ADRs.
Incremental Re-scan: Updates the architecture map by scanning only changed subfolders for efficiency.

Quick Start

Run the survey Skill with the command 'survey the codebase' or 'set up a new project'.

Frequently Asked Questions about survey

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

FAQPage Schema

How do I map the architecture of an existing codebase?▼

Mapping codebase architecture involves scanning the existing project to identify languages, frameworks, data stores, and inter-module communication. The survey Skill automates this discovery and checks consistency with predefined conventions and ADRs.

What is the best way to set up architecture for a new greenfield project?▼

Setting up architecture for a new project involves selecting a default stack and generating foundational ADRs. The survey Skill guides you through greenfield setup to establish baseline conventions and architectural foundations.

How do I update an architecture map after changing only part of the codebase?▼

Updating an architecture map for partial changes uses incremental re-scanning to target only changed subfolders. This ensures efficient detection and updates without scanning the entire codebase architecture from scratch.

Does the architecture discovery process check for consistency with existing ADRs?▼

Yes, architecture discovery checks for consistency with existing ADRs. The survey Skill automates scanning across various components and ensures that the detected setup aligns with predefined conventions and architectural decision records.

Can I assess both greenfield and brownfield codebases with the same tool?▼

Yes, you can assess both greenfield and brownfield codebases. The survey Skill detects the project status to either guide foundational greenfield setup or perform targeted brownfield scans for incremental architecture updates.