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
<strong>An open source toolkit that allows you to focus on product scenarios and predictable outcomes instead of vibe coding every piece from scratch.</strong>
9
9
</p>
10
10
11
+
## 🎯 Project Vision
12
+
13
+
This fork combines the [Agentic SDLC 12 Factors](https://tikalk.github.io/agentic-sdlc-12-factors/) methodology with Spec-Driven Development to create a comprehensive framework for AI-assisted software development. The 12 Factors provide the strategic foundation and operational principles, while Spec-Driven Development delivers the practical implementation workflow.
14
+
15
+
### Why This Combination?
16
+
17
+
**Agentic SDLC 12 Factors** establish the philosophical and strategic principles for building software with AI coding agents, covering aspects like strategic mindset, context scaffolding, dual execution loops, and team capability.
18
+
19
+
**Spec-Driven Development** provides the concrete, actionable process for implementing these principles through structured specification, planning, task breakdown, and iterative implementation phases.
20
+
21
+
Together, they form a complete methodology that transforms how organizations approach AI-assisted development, moving from ad-hoc AI usage to systematic, high-quality software production.
22
+
23
+
### Why This Fork?
24
+
25
+
The original [github/spec-kit](https://github.com/github/spec-kit) repository focused on the core Spec-Driven Development process. This fork extends that foundation by:
26
+
27
+
-**Integrating the 12 Factors methodology** as the strategic layer above the tactical Spec-Driven process
28
+
-**Adding enterprise-grade features** like team AI directives integration
29
+
-**Enhancing tooling** with dual execution loop support (SYNC/ASYNC task classification)
30
+
-**Implementing AI session context management** through the levelup command that creates reusable knowledge packets and analyzes contributions to team directives
31
+
-**Providing team templates** and best practices for scaling AI-assisted development across teams
32
+
33
+
This fork represents the evolution from a development process to a complete organizational methodology for AI-native software development, with sophisticated knowledge management and cross-project learning capabilities.
@@ -304,7 +333,7 @@ See Spec-Driven Development in action across different scenarios with these comm
304
333
## 🛠️ Community Friends
305
334
306
335
> [!NOTE]
307
-
> Community projects listed here are independently created and maintained by their respective authors. They are **not reviewed, nor endorsed, nor supported by GitHub**. Review their source code before installation and use at your own discretion.
336
+
> Community projects listed here are independently created and maintained by their respective authors. They are **not reviewed, nor endorsed, nor supported by GitHub**. Review their source code before following along and use at your own discretion.
308
337
309
338
Community projects that extend, visualize, or build on Spec Kit:
310
339
@@ -314,6 +343,69 @@ Community projects that extend, visualize, or build on Spec Kit:
314
343
315
344
-**[SpecKit Companion](https://marketplace.visualstudio.com/items?itemName=alfredoperez.speckit-companion)** — A VS Code extension that brings a visual GUI to Spec Kit. Browse specs in a rich markdown viewer with clickable file references, create specifications with image attachments, comment and refine each step inline (GitHub-style review), track your progress through the SDD workflow with a visual phase stepper, and manage steering documents like constitutions and templates.
316
345
346
+
## 🎯 Core Features
347
+
348
+
This fork provides additional features beyond the upstream Spec Kit:
349
+
350
+
-**Team AI Directives Integration** — Synchronize team-level AI instructions and context across projects
351
+
-**Dual Execution Loop** — Classify tasks as SYNC (immediate) or ASYNC (deferred) for better workflow management
352
+
-**Levelup Command** — Analyze and improve session context with reusable knowledge packets
353
+
-**Enhanced Extensions** — Built-in extensions for product thinking, architecture analysis, and TDD workflows
354
+
355
+
## 📦 Bundled Extensions
356
+
357
+
This fork includes pre-installed extensions:
358
+
359
+
| Extension | Purpose |
360
+
|-----------|---------|
361
+
| architect | Architecture impact analysis and decision guidance |
362
+
| evals | Evaluation criteria and test generation |
363
+
| levelup | Session context improvement and knowledge management |
364
+
| product | Product thinking and user story refinement |
365
+
| quick | Quick start workflows for small tasks |
366
+
| tdd | Test-driven development workflows |
367
+
| git | Git workflow automation |
368
+
369
+
## 🤖 Supported AI Agents
370
+
371
+
This fork supports the following AI coding agents:
372
+
373
+
| Agent | CLI | Skills | Setup |
374
+
|-------|-----|--------|-------|
375
+
| Claude Code |`claude`| ✓ |`--ai claude --ai-skills`|
376
+
| GitHub Copilot | — | IDE |`--ai copilot`|
377
+
| Cursor |`cursor-agent`| IDE |`--ai cursor-agent`|
The fork includes a skills package manager for managing reusable AI session context:
389
+
390
+
```bash
391
+
# List installed skills
392
+
specify skills list
393
+
394
+
# Install a skill package
395
+
specify skills install <package>
396
+
397
+
# Update skills
398
+
specify skills update
399
+
```
400
+
401
+
## Relevant Skills (Auto-Detected)
402
+
403
+
When you initialize a project, the following skills are auto-detected based on your AI assistant selection:
404
+
405
+
-**Claude Code**: `.claude/skills/` — Skills installed from the specification
406
+
-**Codex**: `.agents/skills/` — Skills installed via Codex CLI
407
+
-**Custom**: Based on your selected integration
408
+
317
409
## 🤖 Supported AI Coding Agent Integrations
318
410
319
411
Spec Kit works with 30+ AI coding agents — both CLI tools and IDE-based assistants. See the full list with notes and usage details in the [Supported AI Coding Agent Integrations](https://github.github.io/spec-kit/reference/integrations.html) guide.
@@ -755,22 +847,10 @@ Once the implementation is complete, test the application and resolve any runtim
755
847
756
848
## 🔍 Troubleshooting
757
849
758
-
### Git Credential Manager on Linux
759
-
760
-
If you're having issues with Git authentication on Linux, you can install Git Credential Manager:
0 commit comments