Skip to content

Commit be55903

Browse files
committed
chore: merge upstream v0.8.0 and release 0.8.0+adlc1
- Merged upstream github/spec-kit v0.8.0 changes - Fork customizations preserved: - cli_customization.py: Added FORK_GITHUB_API_LATEST and FORK_INSTALL_COMMAND - __init__.py: self check/upgrade commands use fork's GitHub API - extensions.py: EXTENSION_NAMESPACES support for adlc.* prefix - pyproject.toml: Package name agentic-sdlc-specify-cli, version 0.8.0+adlc1 - Restored fork-specific test files from backup - Fixed _install_shared_infra force parameter - Fixed InvalidMetadataError handling in _get_installed_version - Fixed YAML mapping validation in ExtensionManifest._load_yaml - Updated test assertions for fork URL patterns
2 parents 3ecbc0f + 6bf4ebb commit be55903

33 files changed

Lines changed: 4797 additions & 131 deletions

.zenodo.json

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
{
2+
"title": "Spec Kit",
3+
"description": "Spec Kit is an open source toolkit for Spec-Driven Development (SDD) — a methodology that helps software teams build high-quality software faster by focusing on product scenarios and predictable outcomes. It provides the Specify CLI, slash-command templates, extensions, presets, workflows, and integrations for popular AI coding agents.",
4+
"creators": [
5+
{
6+
"name": "Delimarsky, Den"
7+
},
8+
{
9+
"name": "Riem, Manfred"
10+
}
11+
],
12+
"license": "MIT",
13+
"upload_type": "software",
14+
"keywords": [
15+
"spec-driven development",
16+
"ai coding agents",
17+
"software engineering",
18+
"cli",
19+
"copilot",
20+
"specification"
21+
],
22+
"related_identifiers": [
23+
{
24+
"identifier": "https://github.com/github/spec-kit",
25+
"relation": "isSupplementTo",
26+
"scheme": "url"
27+
}
28+
]
29+
}

CHANGELOG.md

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,28 @@ All notable changes to the Specify CLI and templates are documented here.
44

55
# [Unreleased]
66

7+
# [0.8.0+adlc1] - 2026-04-24
8+
9+
### Changed
10+
11+
- **Upstream sync**: Merged upstream v0.8.0 with fork customizations preserved
12+
- `specify self check` now uses fork's GitHub API (`tikalk/agentic-sdlc-spec-kit`)
13+
- `specify self upgrade` shows fork's install command
14+
- Added `FORK_GITHUB_API_LATEST` and `FORK_INSTALL_COMMAND` to `cli_customization.py`
15+
16+
### Fixed
17+
18+
- **_install_shared_infra force parameter**: Added `force` parameter to allow overwriting existing shared files
19+
- **InvalidMetadataError handling**: `_get_installed_version()` now handles `InvalidMetadataError` for corrupted package metadata
20+
- **YAML mapping validation**: `ExtensionManifest._load_yaml()` now properly rejects non-mapping YAML (scalars, lists)
21+
22+
### Added
23+
24+
- **Upstream features from v0.8.0**:
25+
- `specify self check` command to check for updates
26+
- `specify self upgrade` stub command
27+
- New agent integrations and improvements
28+
729
# [0.5.17] - 2026-04-24
830

931
### Changed
@@ -1323,6 +1345,51 @@ This release migrates fork-specific customizations to a preset system to reduce
13231345

13241346
The following entries are from the upstream spec-kit project and are included for reference.
13251347

1348+
## [0.8.0] - 2026-04-23
1349+
1350+
### Changed
1351+
1352+
- feat(presets): Composition strategies (prepend, append, wrap) for templates, commands, and scripts (#2133)
1353+
- feat(copilot): support `--integration-options="--skills"` for skills-based scaffolding (#2324)
1354+
- docs(install): add pipx as alternative installation method (#2288)
1355+
- Add Memory MD community extension (#2327)
1356+
- Update version-guard to v1.2.0 (#2321)
1357+
- fix: `--force` now overwrites shared infra files during init and upgrade (#2320)
1358+
- chore: release 0.7.5, begin 0.7.6.dev0 development (#2322)
1359+
1360+
## [0.7.5] - 2026-04-22
1361+
1362+
### Changed
1363+
1364+
- fix: resolve skill placeholders for all SKILL.md agents, not just codex/kimi (#2313)
1365+
- feat(cli): add specify self check and self upgrade stub (#2316)
1366+
- Update version-guard to v1.1.0 (#2318)
1367+
- docs: move community presets from README to docs/community (#2314)
1368+
- catalog: add wireframe extension (v0.1.1) (#2262)
1369+
- Move community walkthroughs from README to docs/community (#2312)
1370+
- docs(readme): list red-team in community-extensions table (#2311)
1371+
- feat(catalog): add red-team extension to community catalog (#2306)
1372+
- Add superpowers-bridge community extension (#2309)
1373+
- feat: implement preset wrap strategy (#2189)
1374+
- fix(agents): block directory traversal in command write paths (#2229) (#2296)
1375+
- chore: release 0.7.4, begin 0.7.5.dev0 development (#2299)
1376+
1377+
## [0.7.4] - 2026-04-21
1378+
1379+
### Changed
1380+
1381+
- fix(copilot): use --yolo to grant all permissions in non-interactive mode (#2298)
1382+
- feat: add CITATION.cff and .zenodo.json for academic citation support (#2291)
1383+
- Add spec-validate to community catalog (#2274)
1384+
- feat: register Ripple in community catalog (#2272)
1385+
- Add version-guard to community catalog (#2286)
1386+
- Add spec-reference-loader to community catalog (#2285)
1387+
- Add memory-loader to community catalog (#2284)
1388+
- fix(integrations): strip UTF-8 BOM when reading agent context files (#2283)
1389+
- Preset fiction book writing1.6 (#2270)
1390+
- fix(integrations): migrate Antigravity (agy) layout to .agents/ and deprecate --skills (#2276)
1391+
- chore: release 0.7.3, begin 0.7.4.dev0 development (#2263)
1392+
13261393
## [0.7.3] - 2026-04-17
13271394

13281395
### Changed

CITATION.cff

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
cff-version: 1.2.0
2+
message: >-
3+
If you use Spec Kit in your research or reference it in a paper,
4+
please cite it using the metadata below.
5+
type: software
6+
title: "Spec Kit"
7+
abstract: >-
8+
Spec Kit is an open source toolkit for Spec-Driven Development (SDD) —
9+
a methodology that helps software teams build high-quality software faster
10+
by focusing on product scenarios and predictable outcomes. It provides the
11+
Specify CLI, slash-command templates, extensions, presets, workflows, and
12+
integrations for popular AI coding agents.
13+
authors:
14+
- given-names: Den
15+
family-names: Delimarsky
16+
alias: localden
17+
- given-names: Manfred
18+
family-names: Riem
19+
alias: mnriem
20+
repository-code: "https://github.com/github/spec-kit"
21+
url: "https://github.github.io/spec-kit/"
22+
license: MIT
23+
version: "0.7.3"
24+
date-released: "2026-04-17"
25+
keywords:
26+
- spec-driven development
27+
- ai coding agents
28+
- software engineering
29+
- cli
30+
- copilot
31+
- specification

docs/community/presets.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Community Presets
2+
3+
> [!NOTE]
4+
> Community presets are independently created and maintained by their respective authors. GitHub and the Spec Kit maintainers may review pull requests that add entries to the community catalog for formatting, catalog structure, or policy compliance, but they do **not review, audit, endorse, or support the preset code itself**. Review preset source code before installation and use at your own discretion.
5+
6+
The following community-contributed presets customize how Spec Kit behaves — overriding templates, commands, and terminology without changing any tooling. Presets are available in [`catalog.community.json`](https://github.com/github/spec-kit/blob/main/presets/catalog.community.json):
7+
8+
| Preset | Purpose | Provides | Requires | URL |
9+
|--------|---------|----------|----------|-----|
10+
| AIDE In-Place Migration | Adapts the AIDE extension workflow for in-place technology migrations (X → Y pattern) — adds migration objectives, verification gates, knowledge documents, and behavioral equivalence criteria | 2 templates, 8 commands | AIDE extension | [spec-kit-presets](https://github.com/mnriem/spec-kit-presets) |
11+
| Canon Core | Adapts original Spec Kit workflow to work together with Canon extension | 2 templates, 8 commands || [spec-kit-canon](https://github.com/maximiliamus/spec-kit-canon) |
12+
| Claude AskUserQuestion | Upgrades `/speckit.clarify` and `/speckit.checklist` on Claude Code from Markdown-table prompts to the native AskUserQuestion picker, with a recommended option and reasoning on every question | 2 commands || [spec-kit-preset-claude-ask-questions](https://github.com/0xrafasec/spec-kit-preset-claude-ask-questions) |
13+
| Explicit Task Dependencies | Adds explicit `(depends on T###)` dependency declarations and an Execution Wave DAG to tasks.md for parallel scheduling | 1 template, 1 command || [spec-kit-preset-explicit-task-dependencies](https://github.com/Quratulain-bilal/spec-kit-preset-explicit-task-dependencies) |
14+
| Fiction Book Writing | It adapts the Spec-Driven Development workflow for storytelling to create books or audiobooks (with annotations) in 12 languages: features become story elements, specs become story briefs, plans become story structures, and tasks become scene-by-scene writing tasks. Supports single and multi-POV, all major plot structure frameworks, and two style modes: an author voice sample or humanized AI prose. Supports interactive elements like brainstorming, interview, roleplay and extras like statistics, cover builder and bio command. Export with templates for KDP, D2D etc. | 22 templates, 27 commands || [spec-kit-preset-fiction-book-writing](https://github.com/adaumann/speckit-preset-fiction-book-writing) |
15+
| Multi-Repo Branching | Coordinates feature branch creation across multiple git repositories (independent repos and submodules) during plan and tasks phases | 2 commands || [spec-kit-preset-multi-repo-branching](https://github.com/sakitA/spec-kit-preset-multi-repo-branching) |
16+
| Pirate Speak (Full) | Transforms all Spec Kit output into pirate speak — specs become "Voyage Manifests", plans become "Battle Plans", tasks become "Crew Assignments" | 6 templates, 9 commands || [spec-kit-presets](https://github.com/mnriem/spec-kit-presets) |
17+
| Table of Contents Navigation | Adds a navigable Table of Contents to generated spec.md, plan.md, and tasks.md documents | 3 templates, 3 commands || [spec-kit-preset-toc-navigation](https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation) |
18+
| VS Code Ask Questions | Enhances the clarify command to use `vscode/askQuestions` for batched interactive questioning. | 1 command || [spec-kit-presets](https://github.com/fdcastel/spec-kit-presets) |
19+
20+
To build and publish your own preset, see the [Presets Publishing Guide](https://github.com/github/spec-kit/blob/main/presets/PUBLISHING.md).

docs/community/walkthroughs.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Community Walkthroughs
2+
3+
> [!NOTE]
4+
> Community walkthroughs are independently created and maintained by their respective authors. They are **not reviewed, nor endorsed, nor supported by GitHub**. Review their content before following along and use at your own discretion.
5+
6+
See Spec-Driven Development in action across different scenarios with these community-contributed walkthroughs:
7+
8+
- **[Greenfield .NET CLI tool](https://github.com/mnriem/spec-kit-dotnet-cli-demo)** — Builds a Timezone Utility as a .NET single-binary CLI tool from a blank directory, covering the full spec-kit workflow: constitution, specify, plan, tasks, and multi-pass implement using GitHub Copilot agents.
9+
10+
- **[Greenfield Spring Boot + React platform](https://github.com/mnriem/spec-kit-spring-react-demo)** — Builds an LLM performance analytics platform (REST API, graphs, iteration tracking) from scratch using Spring Boot, embedded React, PostgreSQL, and Docker Compose, with a clarify step and a cross-artifact consistency analysis pass included.
11+
12+
- **[Brownfield ASP.NET CMS extension](https://github.com/mnriem/spec-kit-aspnet-brownfield-demo)** — Extends an existing open-source .NET CMS (CarrotCakeCMS-Core, ~307,000 lines of C#, Razor, SQL, JavaScript, and config files) with two new features — cross-platform Docker Compose infrastructure and a token-authenticated headless REST API — demonstrating how spec-kit fits into existing codebases without prior specs or a constitution.
13+
14+
- **[Brownfield Java runtime extension](https://github.com/mnriem/spec-kit-java-brownfield-demo)** — Extends an existing open-source Jakarta EE runtime (Piranha, ~420,000 lines of Java, XML, JSP, HTML, and config files across 180 Maven modules) with a password-protected Server Admin Console, demonstrating spec-kit on a large multi-module Java project with no prior specs or constitution.
15+
16+
- **[Brownfield Go / React dashboard demo](https://github.com/mnriem/spec-kit-go-brownfield-demo)** — Demonstrates spec-kit driven entirely from the **terminal using GitHub Copilot CLI**. Extends NASA's open-source Hermes ground support system (Go) with a lightweight React-based web telemetry dashboard, showing that the full constitution → specify → plan → tasks → implement workflow works from the terminal.
17+
18+
- **[Greenfield Spring Boot MVC with a custom preset](https://github.com/mnriem/spec-kit-pirate-speak-preset-demo)** — Builds a Spring Boot MVC application from scratch using a custom pirate-speak preset, demonstrating how presets can reshape the entire spec-kit experience: specifications become "Voyage Manifests," plans become "Battle Plans," and tasks become "Crew Assignments" — all generated in full pirate vernacular without changing any tooling.
19+
20+
- **[Greenfield Spring Boot + React with a custom extension](https://github.com/mnriem/spec-kit-aide-extension-demo)** — Walks through the **AIDE extension**, a community extension that adds an alternative spec-driven workflow to spec-kit with high-level specs (vision) and low-level specs (work items) organized in a 7-step iterative lifecycle: vision → roadmap → progress tracking → work queue → work items → execution → feedback loops. Uses a family trading platform (Spring Boot 4, React 19, PostgreSQL, Docker Compose) as the scenario to illustrate how the extension mechanism lets you plug in a different style of spec-driven development without changing any core tooling — truly utilizing the "Kit" in Spec Kit.

docs/quickstart.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -136,6 +136,17 @@ uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init
136136
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init .
137137
```
138138

139+
> [!NOTE]
140+
> You can also install the CLI persistently with `pipx`:
141+
> ```bash
142+
> pipx install git+https://github.com/github/spec-kit.git
143+
> ```
144+
> After installing with `pipx`, run `specify` directly instead of `uvx --from ... specify`, for example:
145+
> ```bash
146+
> specify init <PROJECT_NAME>
147+
> specify init .
148+
> ```
149+
139150
Pick script type explicitly (optional):
140151
141152
```bash

docs/toc.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,5 +37,9 @@
3737
# Community
3838
- name: Community
3939
items:
40+
- name: Presets
41+
href: community/presets.md
42+
- name: Walkthroughs
43+
href: community/walkthroughs.md
4044
- name: Friends
4145
href: community/friends.md

docs/upgrade.md

Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99
| What to Upgrade | Command | When to Use |
1010
|----------------|---------|-------------|
1111
| **CLI Tool Only** | `uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git@vX.Y.Z` | Get latest CLI features without touching project files |
12+
| **CLI Tool Only (pipx)** | `pipx install --force git+https://github.com/github/spec-kit.git@vX.Y.Z` | Reinstall/upgrade a pipx-installed CLI to a specific release |
1213
| **Project Files** | `specify init --here --force --ai <your-agent>` | Update slash commands, templates, and scripts in your project |
1314
| **Both** | Run CLI upgrade, then project update | Recommended for major version updates |
1415

@@ -34,6 +35,14 @@ Specify the desired release tag:
3435
uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init --here --ai copilot
3536
```
3637

38+
### If you installed with `pipx`
39+
40+
Upgrade to a specific release:
41+
42+
```bash
43+
pipx install --force git+https://github.com/github/spec-kit.git@vX.Y.Z
44+
```
45+
3746
### Verify the upgrade
3847

3948
```bash
@@ -53,8 +62,8 @@ When Spec Kit releases new features (like new slash commands or updated template
5362
Running `specify init --here --force` will update:
5463

5564
-**Slash command files** (`.claude/commands/`, `.github/prompts/`, etc.)
56-
-**Script files** (`.specify/scripts/`)
57-
-**Template files** (`.specify/templates/`)
65+
-**Script files** (`.specify/scripts/`)**only with `--force`**; without it, only missing files are added
66+
-**Template files** (`.specify/templates/`)**only with `--force`**; without it, only missing files are added
5867
-**Shared memory files** (`.specify/memory/`) - **⚠️ See warnings below**
5968

6069
### What stays safe?
@@ -94,7 +103,9 @@ Template files will be merged with existing content and may overwrite existing f
94103
Proceed? [y/N]
95104
```
96105

97-
With `--force`, it skips the confirmation and proceeds immediately.
106+
With `--force`, it skips the confirmation and proceeds immediately. It also **overwrites shared infrastructure files** (`.specify/scripts/` and `.specify/templates/`) with the latest versions from the installed Spec Kit release.
107+
108+
Without `--force`, shared infrastructure files that already exist are skipped — the CLI will print a warning listing the skipped files so you know which ones were not updated.
98109

99110
**Important: Your `specs/` directory is always safe.** The `--force` flag only affects template files (commands, scripts, templates, memory). Your feature specifications, plans, and tasks in `specs/` are never included in upgrade packages and cannot be overwritten.
100111

@@ -126,13 +137,14 @@ Or use git to restore it:
126137
git restore .specify/memory/constitution.md
127138
```
128139

129-
### 2. Custom template modifications
140+
### 2. Custom script or template modifications
130141

131-
If you customized any templates in `.specify/templates/`, the upgrade will overwrite them. Back them up first:
142+
If you customized files in `.specify/scripts/` or `.specify/templates/`, the `--force` flag will overwrite them. Back them up first:
132143

133144
```bash
134-
# Back up custom templates
145+
# Back up custom templates and scripts
135146
cp -r .specify/templates .specify/templates-backup
147+
cp -r .specify/scripts .specify/scripts-backup
136148

137149
# After upgrade, merge your changes back manually
138150
```

0 commit comments

Comments
 (0)