Skip to content

Commit d84d3ed

Browse files
committed
Restore fork customizations in README.md
- Re-add Project Vision section explaining 12 Factors methodology fork - Fix logo and links to tikalk fork URLs - Re-add Core Features, Bundled Extensions sections - Re-add Supported AI Agents with fork-specific agent list - Re-add Skills Package Manager section - Re-add Maintainers section - Update installation commands to use agentic-sdlc-specify-cli - Fix command prefix references for fork commands
1 parent 93ef063 commit d84d3ed

1 file changed

Lines changed: 104 additions & 24 deletions

File tree

README.md

Lines changed: 104 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,60 @@
11
<div align="center">
2-
<img src="./media/logo_large.webp" alt="Spec Kit Logo" width="200" height="200"/>
3-
<h1>🌱 Spec Kit</h1>
2+
<img src="./media/timi_small.png" alt="Agentic SDLC Spec Kit Logo" width="200" height="200"/>
3+
<h1>🐙 Agentic SDLC Spec Kit</h1>
44
<h3><em>Build high-quality software faster.</em></h3>
55
</div>
66

77
<p align="center">
88
<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>
99
</p>
1010

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.
34+
1135
<p align="center">
12-
<a href="https://github.com/github/spec-kit/releases/latest"><img src="https://img.shields.io/github/v/release/github/spec-kit" alt="Latest Release"/></a>
13-
<a href="https://github.com/github/spec-kit/stargazers"><img src="https://img.shields.io/github/stars/github/spec-kit?style=social" alt="GitHub stars"/></a>
14-
<a href="https://github.com/github/spec-kit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/github/spec-kit" alt="License"/></a>
36+
<a href="https://github.com/tikalk/agentic-sdlc-spec-kit/actions/workflows/release.yml"><img src="https://github.com/tikalk/agentic-sdlc-spec-kit/actions/workflows/release.yml/badge.svg" alt="Release"/></a>
37+
<a href="https://github.com/tikalk/agentic-sdlc-spec-kit/stargazers"><img src="https://img.shields.io/github/stars/tikalk/agentic-sdlc-spec-kit?style=social" alt="GitHub stars"/></a>
38+
<a href="https://github.com/tikalk/agentic-sdlc-spec-kit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/tikalk/agentic-sdlc-spec-kit" alt="License"/></a>
1539
<a href="https://github.github.io/spec-kit/"><img src="https://img.shields.io/badge/docs-GitHub_Pages-blue" alt="Documentation"/></a>
1640
</p>
1741

1842
---
1943

2044
## Table of Contents
2145

46+
- [🎯 Project Vision](#-project-vision)
2247
- [🤔 What is Spec-Driven Development?](#-what-is-spec-driven-development)
2348
- [⚡ Get Started](#-get-started)
2449
- [📽️ Video Overview](#️-video-overview)
2550
- [🧩 Community Extensions](#-community-extensions)
2651
- [🎨 Community Presets](#-community-presets)
2752
- [🚶 Community Walkthroughs](#-community-walkthroughs)
53+
- [🎯 Core Features](#-core-features)
54+
- [📦 Extensions](#-extensions)
2855
- [🛠️ Community Friends](#️-community-friends)
29-
- [🤖 Supported AI Coding Agent Integrations](#-supported-ai-coding-agent-integrations)
56+
- [🤖 Supported AI Agents](#-supported-ai-agents)
57+
- [📦 Skills Package Manager](#-skills-package-manager)
3058
- [🔧 Specify CLI Reference](#-specify-cli-reference)
3159
- [🧩 Making Spec Kit Your Own: Extensions & Presets](#-making-spec-kit-your-own-extensions--presets)
3260
- [📚 Core Philosophy](#-core-philosophy)
@@ -36,6 +64,7 @@
3664
- [📖 Learn More](#-learn-more)
3765
- [📋 Detailed Process](#-detailed-process)
3866
- [🔍 Troubleshooting](#-troubleshooting)
67+
- [👥 Maintainers](#-maintainers)
3968
- [💬 Support](#-support)
4069
- [🙏 Acknowledgements](#-acknowledgements)
4170
- [📄 License](#-license)
@@ -58,10 +87,10 @@ Install once and use everywhere. Pin a specific release tag for stability (check
5887

5988
```bash
6089
# Install a specific stable release (recommended — replace vX.Y.Z with the latest tag)
61-
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z
90+
uv tool install agentic-sdlc-specify-cli --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git
6291

6392
# Or install latest from main (may include unreleased changes)
64-
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
93+
uv tool install agentic-sdlc-specify-cli --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git
6594
```
6695

6796
Then verify the correct version is installed:
@@ -304,7 +333,7 @@ See Spec-Driven Development in action across different scenarios with these comm
304333
## 🛠️ Community Friends
305334

306335
> [!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.
308337
309338
Community projects that extend, visualize, or build on Spec Kit:
310339

@@ -314,6 +343,69 @@ Community projects that extend, visualize, or build on Spec Kit:
314343

315344
- **[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.
316345

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` |
378+
| Gemini CLI | `gemini` || `--ai gemini --ai-skills` |
379+
| opencode | `opencode` || `--ai opencode` |
380+
| Qwen | `qwen` || `--ai qwen --ai-skills` |
381+
| Codex | `codex` || `--ai codex --ai-skills` |
382+
| Windsurf || IDE | `--ai windsurf` |
383+
| Junie | `junie` || `--ai junie --ai-skills` |
384+
| And more... |
385+
386+
## 📦 Skills Package Manager
387+
388+
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+
317409
## 🤖 Supported AI Coding Agent Integrations
318410

319411
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
755847

756848
## 🔍 Troubleshooting
757849

758-
### Git Credential Manager on Linux
759-
760-
If you're having issues with Git authentication on Linux, you can install Git Credential Manager:
850+
## 👥 Maintainers
761851

762-
```bash
763-
#!/usr/bin/env bash
764-
set -e
765-
echo "Downloading Git Credential Manager v2.6.1..."
766-
wget https://github.com/git-ecosystem/git-credential-manager/releases/download/v2.6.1/gcm-linux_amd64.2.6.1.deb
767-
echo "Installing Git Credential Manager..."
768-
sudo dpkg -i gcm-linux_amd64.2.6.1.deb
769-
echo "Configuring Git to use GCM..."
770-
git config --global credential.helper manager
771-
echo "Cleaning up..."
772-
rm gcm-linux_amd64.2.6.1.deb
773-
```
852+
- **Lior Banai** — Original author and maintainer
853+
- **Tikalk Agentic SDLC Team** — Fork maintainers
774854

775855
## 💬 Support
776856

0 commit comments

Comments
 (0)