Skip to content

Commit a5edebe

Browse files
committed
chore: rebrand docs and CLI messaging to Agentic SDLC Spec Kit
1 parent 31b6b00 commit a5edebe

File tree

8 files changed

+72
-69
lines changed

8 files changed

+72
-69
lines changed

AGENTS.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# AGENTS.md
22

3-
## About Spec Kit and Specify
3+
## About Agentic SDLC Spec Kit and Specify
44

5-
**GitHub Spec Kit** is a comprehensive toolkit for implementing Spec-Driven Development (SDD) - a methodology that emphasizes creating clear specifications before implementation. The toolkit includes templates, scripts, and workflows that guide development teams through a structured approach to building software.
5+
**Agentic SDLC Spec Kit** is a comprehensive toolkit for implementing Spec-Driven Development (SDD) - a methodology that emphasizes creating clear specifications before implementation. The toolkit includes templates, scripts, and workflows that guide development teams through a structured approach to building software.
66

7-
**Specify CLI** is the command-line interface that bootstraps projects with the Spec Kit framework. It sets up the necessary directory structures, templates, and AI agent integrations to support the Spec-Driven Development workflow.
7+
**Specify CLI** is the command-line interface that bootstraps projects with the Agentic SDLC Spec Kit framework. It sets up the necessary directory structures, templates, and AI agent integrations to support the Spec-Driven Development workflow.
88

99
The toolkit supports multiple AI coding assistants, allowing teams to use their preferred tools while maintaining consistent project structure and development practices.
1010

CONTRIBUTING.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
## Contributing to Spec Kit
1+
## Contributing to Agentic SDLC Spec Kit
22

3-
Hi there! We're thrilled that you'd like to contribute to Spec Kit. Contributions to this project are [released](https://help.github.com/articles/github-terms-of-service/#6-contributions-under-repository-license) to the public under the [project's open source license](LICENSE).
3+
Hi there! We're thrilled that you'd like to contribute to Agentic SDLC Spec Kit. Contributions to this project are [released](https://help.github.com/articles/github-terms-of-service/#6-contributions-under-repository-license) to the public under the [project's open source license](LICENSE).
44

55
Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
66

@@ -38,23 +38,23 @@ Here are a few things you can do that will increase the likelihood of your pull
3838

3939
## Development workflow
4040

41-
When working on spec-kit:
41+
When working on Agentic SDLC Spec Kit:
4242

4343
1. Test changes with the `specify` CLI commands (`/speckit.specify`, `/speckit.plan`, `/speckit.tasks`) in your coding agent of choice
4444
2. Verify templates are working correctly in `templates/` directory
4545
3. Test script functionality in the `scripts/` directory
4646
4. Ensure memory files (`memory/constitution.md`) are updated if major process changes are made
4747

48-
## AI contributions in Spec Kit
48+
## AI contributions in Agentic SDLC Spec Kit
4949

5050
> [!IMPORTANT]
5151
>
52-
> If you are using **any kind of AI assistance** to contribute to Spec Kit,
52+
> If you are using **any kind of AI assistance** to contribute to Agentic SDLC Spec Kit,
5353
> it must be disclosed in the pull request or issue.
5454
55-
We welcome and encourage the use of AI tools to help improve Spec Kit! Many valuable contributions have been enhanced with AI assistance for code generation, issue detection, and feature definition.
55+
We welcome and encourage the use of AI tools to help improve Agentic SDLC Spec Kit! Many valuable contributions have been enhanced with AI assistance for code generation, issue detection, and feature definition.
5656

57-
That being said, if you are using any kind of AI assistance (e.g., agents, ChatGPT) while contributing to Spec Kit,
57+
That being said, if you are using any kind of AI assistance (e.g., agents, ChatGPT) while contributing to Agentic SDLC Spec Kit,
5858
**this must be disclosed in the pull request or issue**, along with the extent to which AI assistance was used (e.g., documentation comments vs. code generation).
5959

6060
If your PR responses or comments are being generated by an AI, disclose that as well.
@@ -82,7 +82,7 @@ When submitting AI-assisted contributions, please ensure they include:
8282

8383
- **Clear disclosure of AI use** - You are transparent about AI use and degree to which you're using it for the contribution
8484
- **Human understanding and testing** - You've personally tested the changes and understand what they do
85-
- **Clear rationale** - You can explain why the change is needed and how it fits within Spec Kit's goals
85+
- **Clear rationale** - You can explain why the change is needed and how it fits within Agentic SDLC Spec Kit's goals
8686
- **Concrete evidence** - Include test cases, scenarios, or examples that demonstrate the improvement
8787
- **Your own analysis** - Share your thoughts on the end-to-end developer experience
8888

@@ -91,7 +91,7 @@ When submitting AI-assisted contributions, please ensure they include:
9191
We reserve the right to close contributions that appear to be:
9292

9393
- Untested changes submitted without verification
94-
- Generic suggestions that don't address specific Spec Kit needs
94+
- Generic suggestions that don't address specific Agentic SDLC Spec Kit needs
9595
- Bulk submissions that show no human review or understanding
9696

9797
### Guidelines for success

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<div align="center">
22
<img src="./media/logo_small.webp"/>
3-
<h1>🌱 Spec Kit</h1>
3+
<h1>🌱 Agentic SDLC Spec Kit</h1>
44
<h3><em>Build high-quality software faster.</em></h3>
55
</div>
66

SUPPORT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ For help or questions about using this project, please:
1212

1313
## Project Status
1414

15-
**Spec Kit** is under active development and maintained by GitHub staff **AND THE COMMUNITY**. We will do our best to respond to support, feature requests, and community questions in a timely manner.
15+
**Agentic SDLC Spec Kit** is under active development and maintained by GitHub staff **AND THE COMMUNITY**. We will do our best to respond to support, feature requests, and community questions in a timely manner.
1616

1717
## GitHub Support Policy
1818

docs/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Documentation
22

3-
This folder contains the documentation source files for Spec Kit, built using [DocFX](https://dotnet.github.io/docfx/).
3+
This folder contains the documentation source files for Agentic SDLC Spec Kit, built using [DocFX](https://dotnet.github.io/docfx/).
44

55
## Building Locally
66

docs/quickstart.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Quick Start Guide
22

3-
This guide will help you get started with Spec-Driven Development using Spec Kit.
3+
This guide will help you get started with Spec-Driven Development using Agentic SDLC Spec Kit.
44

55
> NEW: All automation scripts now provide both Bash (`.sh`) and PowerShell (`.ps1`) variants. The `specify` CLI auto-selects based on OS unless you pass `--script sh|ps`.
66
@@ -10,7 +10,7 @@ This guide will help you get started with Spec-Driven Development using Spec Kit
1010
**Note:** Run these steps in a standard terminal before opening the Intelligent IDE.
1111

1212
1. **Project Initialization (`/init`)**
13-
**Action:** From the project root, run the Spec Kit `init` command (e.g., `specify init <project> --team-ai-directive https://github.com/your-org/team-ai-directives.git`) to configure local settings and clone the shared `team-ai-directives` modules.
13+
**Action:** From the project root, run the Agentic SDLC Spec Kit `init` command (e.g., `specify init <project> --team-ai-directives https://github.com/your-org/team-ai-directives.git`) to configure local settings and clone the shared `team-ai-directives` modules.
1414
**Purpose:** Creates the handshake that brings the repository into the managed Agentic SDLC ecosystem, wiring credentials, endpoints, and shared knowledge needed for subsequent commands.
1515
2. **Establishing the Constitution (`/constitution`)**
1616
**Action:** Within the IDE, execute `/constitution`, importing relevant modules from `team-ai-directives` and adding any project-specific principles.
@@ -27,13 +27,13 @@ This guide will help you get started with Spec-Driven Development using Spec Kit
2727
## Stage 1: Feature Specification
2828

2929
**Goal:** Produce a committed `spec.md` that captures the feature's intent, constraints, and acceptance criteria.
30-
**Note:** From Stage 1 onward, all work happens inside the Intelligent IDE with the context automatically assembled by Spec Kit.
30+
**Note:** From Stage 1 onward, all work happens inside the Intelligent IDE with the context automatically assembled by Agentic SDLC Spec Kit.
3131

3232
1. **Craft the Directive (`/specify`)**
3333
**Action:** Author a single, comprehensive natural-language directive that blends the issue tracker mission, personas, constraints, and any clarifications.
3434
**Purpose:** Front-load human judgment so the AI can draft an accurate `spec.md` aligned with the constitution.
3535
2. **Execute the Command**
36-
**Action:** Run `/specify` in the IDE; Spec Kit loads `memory/constitution.md`, resolves `@team/...` references against the directives repo, and captures any `@issue-tracker ISSUE-###` reference in the prompt so the resulting spec links back to the originating ticket.
36+
**Action:** Run `/specify` in the IDE; Agentic SDLC Spec Kit loads `memory/constitution.md`, resolves `@team/...` references against the directives repo, and captures any `@issue-tracker ISSUE-###` reference in the prompt so the resulting spec links back to the originating ticket.
3737
**Purpose:** Generates the structured specification artifact under `specs/<feature>/spec.md` with shared principles and traceability already in context.
3838
3. **Review and Commit**
3939
**Action:** Perform a macro-review of the generated `spec.md`, refine if needed, then commit it.
@@ -53,7 +53,7 @@ This guide will help you get started with Spec-Driven Development using Spec Kit
5353
**Note:** `/plan` and `/tasks` run inside the IDE, reusing the constitution and the locally cloned `team-ai-directives` modules.
5454

5555
1. **Generate the Plan (`/plan`)**
56-
**Action:** Execute `/plan` with a directive that covers tech stack, risk considerations, testing focus, and any implementation preferences. Spec Kit loads `memory/constitution.md`, references in `team-ai-directives`, and copies the plan template before executing automation.
56+
**Action:** Execute `/plan` with a directive that covers tech stack, risk considerations, testing focus, and any implementation preferences. Agentic SDLC Spec Kit loads `memory/constitution.md`, references in `team-ai-directives`, and copies the plan template before executing automation.
5757
**Purpose:** Guides the AI in generating a comprehensive and strategically-sound first draft of `plan.md`—front-loading human judgment yields more robust outputs, and the AI produces technical steps with preliminary [SYNC]/[ASYNC] triage suggestions while emitting `plan.md`, `research.md`, `data-model.md`, `quickstart.md`, and contract stubs aligned with the constitution.
5858
2. **Macro-Review and Commit**
5959
**Action:** Review the generated artifacts, adjust as needed, decide [SYNC]/[ASYNC] triage, then commit.
@@ -84,7 +84,7 @@ This guide will help you get started with Spec-Driven Development using Spec Kit
8484
**Note:** `/levelup` runs inside the IDE and relies on the locally cloned directives repository from Stage 0.
8585

8686
1. **Run Level-Up Workflow (`/levelup`)**
87-
**Action:** Invoke `/levelup` with a strategic directive (e.g., highlight what should become reusable). Spec Kit gathers spec/plan/tasks metadata, validates the directives repo, and prompts you to synthesize a knowledge asset plus PR/issue summaries.
87+
**Action:** Invoke `/levelup` with a strategic directive (e.g., highlight what should become reusable). Agentic SDLC Spec Kit gathers spec/plan/tasks metadata, validates the directives repo, and prompts you to synthesize a knowledge asset plus PR/issue summaries.
8888
**Purpose:** Produces a draft markdown asset under `.specify/memory/team-ai-directives/drafts/`, along with a pull-request description and trace comment for review.
8989
2. **Review & Publish**
9090
**Action:** Inspect the generated asset and summaries. When satisfied, confirm inside `/levelup` to let it create a `levelup/{slug}` branch, commit the asset, push (when remotes are configured), open a PR via `gh pr create` (or emit the command), and post the trace comment (or provide the text if automation is unavailable).

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
[project]
22
name = "specify-cli"
33
version = "0.0.18"
4-
description = "Specify CLI, part of GitHub Spec Kit. A tool to bootstrap your projects for Spec-Driven Development (SDD)."
4+
description = "Specify CLI, part of Agentic SDLC Spec Kit. A tool to bootstrap your projects for Spec-Driven Development (SDD)."
55
requires-python = ">=3.11"
66
dependencies = [
77
"typer",

0 commit comments

Comments
 (0)