gsd-scan

Run a scoped codebase scan and output planning documents to .planning/codebase/.

Updated Jan 28, 2025
One-click install
npx skills add https://github.com/aslaii/dotfiles --skill gsd-scan-aslaii
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-scan
Source: https://github.com/aslaii/dotfiles/tree/main/claude/skills/gsd-scan
Command: npx skills add https://github.com/aslaii/dotfiles --skill gsd-scan-aslaii

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Focused assessment of a codebase by running a scoped scan that outputs targeted planning documents to .planning/codebase/.

Core Features & Use Cases

  • Focused, single-area codebase scanning with optional --focus for tech, arch, quality, concerns, or tech+arch
  • Outputs documents to .planning/codebase/ for downstream planning and decision making
  • Lightweight alternative to full multi-mapper workflows by using a single mapper

Quick Start

Invoke gsd-scan against the target codebase to generate focused planning documents in .planning/codebase/.

Frequently Asked Questions about gsd-scan

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

FAQPage Schema
How do I run a focused codebase scan to get quick architecture insights?

Run a scoped codebase scan using a single mapper workflow to analyze a specific area like architecture or tech stack. It outputs targeted planning documents to .planning/codebase/ for immediate downstream decision making.

What is the difference between a focused codebase scan and a full multi-mapper workflow?

A focused codebase scan uses a single mapper to quickly assess one specific area, providing a lightweight alternative to the full multi-mapper workflow. This delivers deterministic results faster for targeted planning needs.

Can I target a specific code quality concern during a codebase analysis?

Yes, you can target a specific code quality concern by applying the --focus flag during the codebase analysis. This restricts the scoped scan to quality, tech, arch, concerns, or tech+arch assessments.

Where does the scoped scan output its planning documents?

The scoped scan outputs its generated planning documents directly to the .planning/codebase/ directory. These files summarize the assessed codebase area for downstream planning and decision making.

When should I avoid using a focused single-area codebase scan?

Avoid a focused single-area codebase scan when you need comprehensive cross-domain analysis or multi-layered architectural mapping across the entire project. It only supports a single mapper workflow for quick, targeted assessments.