project-scan

Surveys brownfield codebases to map architecture, technologies and epic areas.

2|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/telum-ai/speck --skill project-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-scan
Source: https://github.com/telum-ai/speck/tree/main/.cursor/skills/project-scan
Command: npx skills add https://github.com/telum-ai/speck --skill project-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you quickly understand the architecture and identify potential areas of work in existing, complex codebases without deep diving.

Core Features & Use Cases

  • Architecture Overview: Get a high-level view of project structure (monolith, microservices, modular).
  • Technology Inventory: Identify primary languages and frameworks.
  • Potential Epic Identification: Pinpoint areas with high keyword density or module coupling that might represent features or modules.
  • Use Case: After importing a large, unfamiliar brownfield project, use this Skill to get a rapid 10,000-foot view, identify key functional areas like 'authentication' or 'payment processing', and decide where to focus your next, more detailed scan.

Quick Start

Run a quick landscape survey of the current project to identify potential epic areas.

Frequently Asked Questions about project-scan

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

FAQPage Schema
How do I discover the architecture of an unfamiliar brownfield codebase?

To discover the architecture of an unfamiliar brownfield codebase, perform a rapid high-level survey using keyword heatmaps and simplified coupling analysis to identify structural patterns like monolith or microservices.

What is the best way to identify potential epics in a large existing project?

Identifying potential epics in a large existing project involves scanning for areas with high keyword density or significant module coupling, which often represent key functional features like authentication or payment processing.

Can I get a technology inventory of primary languages and frameworks without deep diving into the code?

You can get a technology inventory of primary languages and frameworks without deep diving by running a rapid landscape survey that highlights major technologies used across the project at a 10,000-foot view.

How do I prepare for a detailed codebase analysis after an initial scan?

To prepare for detailed codebase analysis after an initial scan, use the directional insights from your high-level survey to decide where to focus subsequent targeted scans for epics or stories.

Does a high-level codebase survey provide enough detail for implementation planning?

A high-level codebase survey does not provide enough detail for implementation planning, as it is designed to offer rapid directional insights rather than deep analysis of individual modules or specific code components.