sdd-steering

Generate product, tech, and structure guides under .spec/steering from project manifests.

48|4|Updated Sep 8, 2025
One-click install
npx skills add https://github.com/yi-john-huang/sdd-mcp --skill sdd-steering-yi-john-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-steering
Source: https://github.com/yi-john-huang/sdd-mcp/tree/main/.claude/skills/sdd-steering
Command: npx skills add https://github.com/yi-john-huang/sdd-mcp --skill sdd-steering-yi-john-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Steering documents provide project-specific context to guide AI interactions during development, reducing ambiguity and misalignment.

Core Features & Use Cases

  • Generate product.md, tech.md, structure.md, and custom-*.md under .spec/steering based on project characteristics.
  • Incorporate information from project manifests (package.json, pyproject.toml, etc.), directory structure, existing code patterns, and documentation.
  • Use cases include onboarding new developers, aligning architecture decisions, and codifying project conventions.

Quick Start

Run the sdd-steering skill to generate all steering documents for your project.

Frequently Asked Questions about sdd-steering

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

FAQPage Schema
How do I generate project steering docs to guide AI during software development?

To generate project steering docs, this Skill analyzes project manifests like package.json, directory structures, and existing conventions to produce product.md, tech.md, and structure.md files under the .spec/steering directory.

What are AI steering documents and when do I need them?

AI steering documents provide project-specific context to reduce ambiguity during development. You need them when onboarding developers, aligning architecture decisions, or codifying project conventions for AI interactions.

Can I generate steering docs from pyproject.toml or go.mod manifest files?

Yes, you can generate steering docs from various manifest files. The Skill analyzes manifests including pyproject.toml, go.mod, and package.json alongside your directory structure to extract project characteristics.

How do I create custom steering guides for my project conventions?

You create custom steering guides by running the Skill to analyze your code patterns and documentation. It generates custom-*.md files alongside standard guides under .spec/steering based on detected project conventions.

What is the best way to codify project architecture decisions for AI context?

The best way to codify architecture decisions is generating dedicated steering documents. This Skill extracts technical context from manifests and documentation to produce structured tech.md and product.md guides.

Does AI guidance documentation work without existing project manifests?

AI guidance documentation relies on analyzing manifest files like package.json or pyproject.toml. Without these manifests, the Skill lacks the foundational project context needed to generate accurate steering docs.