Python SDD Architecture Skills

This repository contains a Spec-Driven Development skill suite for Python projects. It is designed to be usable from Codex, VS Code agent workflows, and Claude Code while keeping skills/ as the single source of truth.

The intended daily workflow has two manual entry points:

1. Invoke requirements-to-design to clarify non-trivial work and produce a confirmed design document.
2. Invoke spec-driven with that design document path. It updates SPEC.md, waits for SPEC confirmation, implements, verifies, synchronizes, and audits.

The python-architecture skill is used as an internal rules layer for Python package boundaries, public APIs, architecture level decisions, and SPEC/code audits.

Install Into A Project

From the root of the Python project that should use this workflow, run the command for your shell.

Windows PowerShell:

$env:PYTHON_SDD_INSTALL_YES = '1'; irm https://raw.githubusercontent.com/FSQ-lab/python-sdd/main/install.ps1 | iex; Remove-Item Env:PYTHON_SDD_INSTALL_YES

macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/FSQ-lab/python-sdd/main/install.sh | sh -s -- --yes

The installer adds repository-local skills and platform entry points:

• .github/skills/* for Codex-compatible local skills
• AGENTS.md for Codex and VS Code with Codex
• CLAUDE.md for Claude Code
• .github/copilot-instructions.md and .github/prompts/* for GitHub Copilot in VS Code
• SPEC.md if the project does not already have one

Existing files are kept by default. Use force mode to overwrite installed files.

Windows PowerShell:

$env:PYTHON_SDD_INSTALL_YES = '1'; $env:PYTHON_SDD_INSTALL_FORCE = '1'; irm https://raw.githubusercontent.com/FSQ-lab/python-sdd/main/install.ps1 | iex; Remove-Item Env:PYTHON_SDD_INSTALL_YES; Remove-Item Env:PYTHON_SDD_INSTALL_FORCE

macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/FSQ-lab/python-sdd/main/install.sh | sh -s -- --yes --force

Platforms

• Codex: use AGENTS.md plus repository or personal skills.
• VS Code with Codex: use the Codex setup.
• VS Code with GitHub Copilot: use .github/copilot-instructions.md and prompt files that point to skills/.
• Claude Code: use CLAUDE.md plus installed skills.

See docs/usage.md for the bundle layout and docs/platforms.md for platform-specific setup.