You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AGENTS.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
1
# AGENTS.md
2
2
3
-
## About Spec Kit and Specify
3
+
## About Agentic SDLC Spec Kit and Specify
4
4
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.
6
6
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.
8
8
9
9
The toolkit supports multiple AI coding assistants, allowing teams to use their preferred tools while maintaining consistent project structure and development practices.
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
-
## Contributing to Spec Kit
1
+
## Contributing to Agentic SDLC Spec Kit
2
2
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).
4
4
5
5
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.
6
6
@@ -38,23 +38,23 @@ Here are a few things you can do that will increase the likelihood of your pull
38
38
39
39
## Development workflow
40
40
41
-
When working on spec-kit:
41
+
When working on Agentic SDLC Spec Kit:
42
42
43
43
1. Test changes with the `specify` CLI commands (`/speckit.specify`, `/speckit.plan`, `/speckit.tasks`) in your coding agent of choice
44
44
2. Verify templates are working correctly in `templates/` directory
45
45
3. Test script functionality in the `scripts/` directory
46
46
4. Ensure memory files (`memory/constitution.md`) are updated if major process changes are made
47
47
48
-
## AI contributions in Spec Kit
48
+
## AI contributions in Agentic SDLC Spec Kit
49
49
50
50
> [!IMPORTANT]
51
51
>
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,
53
53
> it must be disclosed in the pull request or issue.
54
54
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.
56
56
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,
58
58
**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).
59
59
60
60
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:
82
82
83
83
-**Clear disclosure of AI use** - You are transparent about AI use and degree to which you're using it for the contribution
84
84
-**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
86
86
-**Concrete evidence** - Include test cases, scenarios, or examples that demonstrate the improvement
87
87
-**Your own analysis** - Share your thoughts on the end-to-end developer experience
88
88
@@ -91,7 +91,7 @@ When submitting AI-assisted contributions, please ensure they include:
91
91
We reserve the right to close contributions that appear to be:
92
92
93
93
- 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
95
95
- Bulk submissions that show no human review or understanding
Copy file name to clipboardExpand all lines: SUPPORT.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ For help or questions about using this project, please:
12
12
13
13
## Project Status
14
14
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.
Copy file name to clipboardExpand all lines: docs/quickstart.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Quick Start Guide
2
2
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.
4
4
5
5
> 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`.
6
6
@@ -10,7 +10,7 @@ This guide will help you get started with Spec-Driven Development using Spec Kit
10
10
**Note:** Run these steps in a standard terminal before opening the Intelligent IDE.
11
11
12
12
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.
14
14
**Purpose:** Creates the handshake that brings the repository into the managed Agentic SDLC ecosystem, wiring credentials, endpoints, and shared knowledge needed for subsequent commands.
15
15
2.**Establishing the Constitution (`/constitution`)**
16
16
**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
27
27
## Stage 1: Feature Specification
28
28
29
29
**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.
31
31
32
32
1.**Craft the Directive (`/specify`)**
33
33
**Action:** Author a single, comprehensive natural-language directive that blends the issue tracker mission, personas, constraints, and any clarifications.
34
34
**Purpose:** Front-load human judgment so the AI can draft an accurate `spec.md` aligned with the constitution.
35
35
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.
37
37
**Purpose:** Generates the structured specification artifact under `specs/<feature>/spec.md` with shared principles and traceability already in context.
38
38
3.**Review and Commit**
39
39
**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
53
53
**Note:**`/plan` and `/tasks` run inside the IDE, reusing the constitution and the locally cloned `team-ai-directives` modules.
54
54
55
55
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.
57
57
**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.
58
58
2.**Macro-Review and Commit**
59
59
**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
84
84
**Note:**`/levelup` runs inside the IDE and relies on the locally cloned directives repository from Stage 0.
85
85
86
86
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.
88
88
**Purpose:** Produces a draft markdown asset under `.specify/memory/team-ai-directives/drafts/`, along with a pull-request description and trace comment for review.
89
89
2.**Review & Publish**
90
90
**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).
0 commit comments