Metadata-Version: 2.4
Name: speckitadv
Version: 3.2.0
Summary: Spec Kit Advanced - Zero-Prompt Architecture CLI for AI-powered development
Author: Civyk
License: Proprietary
Project-URL: Homepage, https://github.com/veerabhadra-ponna/spec-kit-adv
Project-URL: Repository, https://github.com/veerabhadra-ponna/spec-kit-adv
Project-URL: Issues, https://github.com/veerabhadra-ponna/spec-kit-adv/issues
Keywords: ai,cli,development,specification,code-generation
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: C
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: pytest-xdist>=3.5.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: pyinstaller>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: pyyaml>=6.0.0; extra == "dev"
Requires-Dist: nuitka>=2.0.0; extra == "dev"
Requires-Dist: ordered-set>=4.1.0; extra == "dev"
Dynamic: license-file

# Spec Kit Advanced

[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE)
[![PyPI](https://img.shields.io/pypi/v/speckitadv.svg)](https://pypi.org/project/speckitadv/)

**Zero-prompt architecture CLI for AI-powered development workflows** — Progressive prompt injection that guides AI agents through structured development stages.

> **If you find this useful, please consider [supporting the project](#support)!**

______________________________________________________________________

## Why Spec Kit Advanced?

AI coding assistants work best with **structured guidance**. Spec Kit Advanced provides:

- **Progressive Prompt Injection** — Small, focused prompts (50-80 lines) at each stage
- **Folder-Based State Management** — Simple state persistence using feature folders
- **Template System** — Reusable templates with variable substitution
- **Multi-Workflow Support** — Specification, planning, implementation, review, and more
- **Cross-Platform** — Works on Linux, macOS, and Windows
- **Free binaries** — Compiled binaries available via PyPI at no cost

______________________________________________________________________

## Quick Start

### Installation

```bash
pip install speckitadv
```

### Setup for Your AI Agent (Optional)

Slash commands are **optional**. You can use direct prompting without any setup (see [Usage](#usage)).

To install slash commands for your AI agent:

```bash
cd /path/to/your/project

# Interactive setup (recommended)
speckitadv init .

# Or configure specific agent
speckitadv init . --ai claude        # Claude Code
speckitadv init . --ai cursor-agent  # Cursor
speckitadv init . --ai windsurf      # Windsurf
speckitadv init . --ai copilot       # GitHub Copilot
speckitadv init . --ai opencode      # OpenCode
speckitadv init . --ai kilocode      # Kilo Code
speckitadv init . --ai antigravity   # Antigravity

# Configure all supported agents at once
speckitadv init . --all
```

### Verify Installation

```bash
speckitadv --version
```

______________________________________________________________________

## Available Workflows

| Command | Description | Stages |
|---------|-------------|--------|
| `constitution` | Create project constitution | 3 |
| `specify` | Create baseline specification | 6 |
| `plan` | Create implementation plan | 4 |
| `tasks` | Generate actionable tasks | 4 |
| `implement` | Execute implementation | 5 |
| `review` | Deep code review and remediation | 2 |
| `tests` | Iterative test implementation | 2 |
| `clarify` | Ask structured questions | 3 |
| `checklist` | Generate quality checklist | 3 |
| `analyze-project` | Analyze existing project | 9+ |
| `deepwiki` | Generate AI-powered wiki documentation | 15 |
| `orchestrate` | Orchestrate complete spec-driven workflow | - |

______________________________________________________________________

## Usage

### List Available Commands

```bash
speckitadv --help
```

### Option 1: Direct Prompting (No Setup Required)

Simply prompt your AI coding assistant directly:

```text
Run CLI: `speckitadv specify`. Follow all instructions in the output.
```

Replace `specify` with any available command:

```text
Run CLI: `speckitadv review`. Follow all instructions in the output.
Run CLI: `speckitadv tests`. Follow all instructions in the output.
Run CLI: `speckitadv plan`. Follow all instructions in the output.
Run CLI: `speckitadv analyze-project`. Follow all instructions in the output.
```

The AI agent will execute the CLI command and follow the emitted prompts automatically.

### Option 2: Slash Commands (Requires Init)

For a more integrated experience, run `speckitadv init` to install slash commands:

```text
/speckitadv.specify     # Start specification workflow
/speckitadv.plan        # Start planning workflow
/speckitadv.implement   # Start implementation workflow
/speckitadv.review      # Start code review workflow
/speckitadv.tests       # Start test implementation workflow
```

**How slash commands work:**

1. User types slash command in their AI assistant
2. Slash command loads a prompt that instructs the AI agent
3. AI agent executes `speckitadv` CLI commands to drive the workflow
4. CLI emits stage prompts that guide the AI through each step

### Auto-Resume

All feature-scoped commands support automatic state detection:

```bash
speckitadv plan --stage=1     # Early stages need explicit --stage
speckitadv plan --stage=2     # Still no state (created at stage 3)
speckitadv plan               # Stage 3+: auto-detects everything!
speckitadv resume             # See what's next
```

______________________________________________________________________

## Integration with civyk-repoix

Spec Kit Advanced integrates with [civyk-repoix](https://pypi.org/project/civyk-repoix/) for enhanced code intelligence:

- **MCP Mode** — Direct integration when MCP is available
- **CLI Mode** — Fallback for restricted environments

The review and test workflows automatically detect which mode is available and use appropriate commands.

______________________________________________________________________

## Configuration

### AGENTS.md

Place `AGENTS.md` in your **repository root** to configure AI agent behavior:

```text
my-project/
├── AGENTS.md          # AI agent guidelines (repo root only)
├── memory/
│   └── constitution.md
└── specs/
```

The AI agent reads `AGENTS.md` at workflow start for project-specific instructions.

______________________________________________________________________

## Support

**Help keep this project alive and growing!**

If Spec Kit Advanced has helped your development workflow, consider supporting its continued development. Your contribution helps with:

- Ongoing maintenance and bug fixes
- New feature development
- Infrastructure costs

**50% of all donations go directly to children's charities** helping those in need. The remaining funds support project maintenance and feature upgrades.

[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Support-orange.svg)](https://buymeacoffee.com/civyk)
[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-blue.svg)](https://ko-fi.com/civyk)

> Every contribution, no matter the size, makes a difference.

______________________________________________________________________

## License

Proprietary — see [LICENSE](LICENSE)

**Free to use**: Compiled binaries are available via PyPI at no cost for personal and commercial use.
