investigating-codebase-for-user-stories

Extract user stories with acceptance criteria from codebase analysis.

125|16|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/aaddrick/claude-pipeline --skill investigating-codebase-for-user-stories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigating-codebase-for-user-stories
Source: https://github.com/aaddrick/claude-pipeline/tree/main/.claude/skills/investigating-codebase-for-user-stories
Command: npx skills add https://github.com/aaddrick/claude-pipeline --skill investigating-codebase-for-user-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill systematically identifies user types, feature areas, and journeys from a codebase to generate structured user stories with acceptance criteria and traceability.

Core Features & Use Cases

  • Identify User Types: Analyze authentication guards, routes, controllers, and models to define distinct user roles.
  • Map Feature Areas: Group functionality by domain (authentication, product, notifications) for coherent storytelling.
  • Trace Journeys & Write Stories: Create end-to-end user stories with acceptance criteria and traceability to code references.
  • Validate Coverage: Ensure every route/view has corresponding stories and dependencies are identified.
  • Save to Files: Persist stories into a structured docs directory for sprint planning.

Quick Start

Install this skill and run it against your codebase to auto-generate a set of user stories with acceptance criteria and dependencies.

Frequently Asked Questions about investigating-codebase-for-user-stories

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

FAQPage Schema
How do I extract user stories from an existing codebase?

Extracting user stories from an existing codebase involves analyzing routes, controllers, and models to identify user types, map feature areas, and trace journeys. This process reverse-engineers requirements into structured narratives with acceptance criteria and traceability for sprint planning.

Can I generate acceptance criteria by reverse-engineering code?

Yes, you can generate acceptance criteria by reverse-engineering code. The skill traces end-to-end user journeys from feature areas like authentication and product domains, writing stories with specific acceptance criteria and mapping dependencies for full traceability.

What is the best way to document undocumented features for onboarding?

Documenting undocumented features for onboarding is best achieved by tracing codebase journeys and grouping functionality by domain. This generates structured user stories with acceptance criteria, ensuring new team members understand routes, views, and dependencies.

How do I map user roles by analyzing authentication guards and routes?

Mapping user roles by analyzing authentication guards and routes identifies distinct user types within the codebase. The skill examines these structures alongside controllers and models to define roles and group functionality into coherent feature areas for storytelling.

Does auto-generating user stories from code ensure full feature coverage?

Auto-generating user stories from code validates coverage by ensuring every route and view has corresponding stories. The skill systematically maps feature areas and records dependencies, verifying that all functionality is documented with traceability.