Skip to content

Commit 3f7ea12

Browse files
committed
fix: restore tikalk pyproject.toml and docs
- Restore agentic-sdlc-specify-cli package name and version 0.1.5 - Restore bundled extensions/presets in wheel build config - Restore tikalk GitHub links in installation.md and upgrade.md - Keep Agentic SDLC 12 Factors reference in docs
1 parent b4eb108 commit 3f7ea12

3 files changed

Lines changed: 66 additions & 31 deletions

File tree

docs/installation.md

Lines changed: 39 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
11
# Installation Guide
22

3+
> Agentic SDLC Spec Kit implements the [Agentic SDLC 12 Factors](https://tikalk.github.io/agentic-sdlc-12-factors/) methodology for structured AI-assisted development.
4+
35
## Prerequisites
46

57
- **Linux/macOS** (or Windows; PowerShell scripts now supported without WSL)
6-
- AI coding agent: [Claude Code](https://www.anthropic.com/claude-code), [GitHub Copilot](https://code.visualstudio.com/), [Codebuddy CLI](https://www.codebuddy.ai/cli), [Gemini CLI](https://github.com/google-gemini/gemini-cli), or [Pi Coding Agent](https://pi.dev)
8+
- AI coding agent: [Claude Code](https://www.anthropic.com/claude-code), [GitHub Copilot](https://code.visualstudio.com/), [Codebuddy CLI](https://www.codebuddy.ai/cli) or [Gemini CLI](https://github.com/google-gemini/gemini-cli)
79
- [uv](https://docs.astral.sh/uv/) for package management
810
- [Python 3.11+](https://www.python.org/downloads/)
911
- [Git](https://git-scm.com/downloads)
@@ -15,27 +17,26 @@
1517
The easiest way to get started is to initialize a new project:
1618

1719
```bash
18-
uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>
20+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <PROJECT_NAME>
1921
```
2022

2123
Or initialize in the current directory:
2224

2325
```bash
24-
uvx --from git+https://github.com/github/spec-kit.git specify init .
26+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init .
2527
# or use the --here flag
26-
uvx --from git+https://github.com/github/spec-kit.git specify init --here
28+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init --here
2729
```
2830

2931
### Specify AI Agent
3032

3133
You can proactively specify your AI agent during initialization:
3234

3335
```bash
34-
uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai claude
35-
uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai gemini
36-
uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai copilot
37-
uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai codebuddy
38-
uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai pi
36+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --ai claude
37+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --ai gemini
38+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --ai copilot
39+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --ai codebuddy
3940
```
4041

4142
### Specify Script Type (Shell vs PowerShell)
@@ -51,27 +52,48 @@ Auto behavior:
5152
Force a specific script type:
5253

5354
```bash
54-
uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --script sh
55-
uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --script ps
55+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --script sh
56+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --script ps
5657
```
5758

5859
### Ignore Agent Tools Check
5960

6061
If you prefer to get the templates without checking for the right tools:
6162

6263
```bash
63-
uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai claude --ignore-agent-tools
64+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --ai claude --ignore-agent-tools
65+
```
66+
67+
### Configure Team AI Directives
68+
69+
Connect to shared team knowledge and standards:
70+
71+
```bash
72+
# Use local team-ai-directives directory
73+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --team-ai-directives ~/workspace/team-ai-directives
74+
75+
# Clone from remote repository
76+
uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --team-ai-directives https://github.com/your-org/team-ai-directives.git
6477
```
6578

6679
## Verification
6780

6881
After initialization, you should see the following commands available in your AI agent:
6982

70-
- `/speckit.specify` - Create specifications
71-
- `/speckit.plan` - Generate implementation plans
72-
- `/speckit.tasks` - Break down into actionable tasks
73-
74-
The `.specify/scripts` directory will contain both `.sh` and `.ps1` scripts.
83+
- `/spec.constitution` - Establish project principles and assemble constitution
84+
- `/spec.specify` - Create specifications
85+
- `/spec.plan` - Generate implementation plans
86+
- `/spec.tasks` - Break down into actionable tasks
87+
- `/spec.implement` - Execute implementation with SYNC/ASYNC dual execution loops
88+
- `/levelup.specify` - Extract patterns from current feature and create CDRs for team knowledge
89+
- `/levelup.init` - Discover patterns from entire codebase (brownfield)
90+
- `/levelup.clarify` - Resolve ambiguities in discovered CDRs
91+
- `/levelup.implement` - Compile CDRs into PR to team-ai-directives
92+
- `/spec.analyze` - Cross-artifact consistency and alignment reports
93+
- `/spec.checklist` - Generate quality checklists for requirements validation
94+
- `/spec.clarify` - Structured questions to de-risk ambiguous areas
95+
96+
The `.specify/scripts` directory will contain both `.sh` and `.ps1` scripts for automation.
7597

7698
## Troubleshooting
7799

docs/upgrade.md

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -151,8 +151,8 @@ cd .kilocode/rules/
151151
ls -la
152152

153153
# Delete old versions (example filenames - yours may differ)
154-
rm speckit.specify-old.md
155-
rm speckit.plan-v1.md
154+
rm spec.specify-old.md
155+
rm spec.plan-v1.md
156156
```
157157

158158
Restart your IDE to refresh the command list.
@@ -204,7 +204,7 @@ cd .kilocode/rules/
204204
ls -la
205205

206206
# Delete old command files
207-
rm speckit.old-command-name.md
207+
rm spec.old-command-name.md
208208

209209
# Restart your IDE
210210
```
@@ -289,9 +289,8 @@ This tells Spec Kit which feature directory to use when creating specs, plans, a
289289

290290
```bash
291291
ls -la .claude/commands/ # Claude Code
292-
ls -la .gemini/commands/ # Gemini
293-
ls -la .cursor/commands/ # Cursor
294-
ls -la .pi/prompts/ # Pi Coding Agent
292+
ls -la .gemini/commands/ # Gemini
293+
ls -la .cursor/commands/ # Cursor
295294
```
296295

297296
3. **Check agent-specific setup:**
@@ -399,7 +398,7 @@ The `specify` CLI tool is used for:
399398
- **Upgrades:** `specify init --here --force` to update templates and commands
400399
- **Diagnostics:** `specify check` to verify tool installation
401400

402-
Once you've run `specify init`, the slash commands (like `/speckit.specify`, `/speckit.plan`, etc.) are **permanently installed** in your project's agent folder (`.claude/`, `.github/prompts/`, `.pi/prompts/`, etc.). Your AI assistant reads these command files directly—no need to run `specify` again.
401+
Once you've run `specify init`, the slash commands (like `/spec.specify`, `/spec.plan`, etc.) are **permanently installed** in your project's agent folder (`.claude/`, `.github/prompts/`, etc.). Your AI assistant reads these command files directly—no need to run `specify` again.
403402

404403
**If your agent isn't recognizing slash commands:**
405404

@@ -411,9 +410,6 @@ Once you've run `specify init`, the slash commands (like `/speckit.specify`, `/s
411410

412411
# For Claude
413412
ls -la .claude/commands/
414-
415-
# For Pi
416-
ls -la .pi/prompts/
417413
```
418414

419415
2. **Restart your IDE/editor completely** (not just reload window)
@@ -442,7 +438,7 @@ Spec Kit follows semantic versioning for major releases. The CLI and project fil
442438

443439
After upgrading:
444440

445-
- **Test new slash commands:** Run `/speckit.constitution` or another command to verify everything works
441+
- **Test new slash commands:** Run `/spec.constitution` or another command to verify everything works
446442
- **Review release notes:** Check [GitHub Releases](https://github.com/github/spec-kit/releases) for new features and breaking changes
447443
- **Update workflows:** If new commands were added, update your team's development workflows
448444
- **Check documentation:** Visit [github.io/spec-kit](https://github.github.io/spec-kit/) for updated guides

pyproject.toml

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[project]
2-
name = "specify-cli"
3-
version = "0.3.1"
2+
name = "agentic-sdlc-specify-cli"
3+
version = "0.1.5"
44
description = "Specify CLI, part of GitHub Spec Kit. A tool to bootstrap your projects for Spec-Driven Development (SDD)."
55
requires-python = ">=3.11"
66
dependencies = [
@@ -14,7 +14,6 @@ dependencies = [
1414
"pyyaml>=6.0",
1515
"packaging>=23.0",
1616
"pathspec>=0.12.0",
17-
"json5>=0.13.0",
1817
]
1918

2019
[project.scripts]
@@ -27,6 +26,24 @@ build-backend = "hatchling.build"
2726
[tool.hatch.build.targets.wheel]
2827
packages = ["src/specify_cli"]
2928

29+
# Include bundled extensions and presets in the wheel
30+
[tool.hatch.build.targets.wheel.force-include]
31+
"extensions/levelup" = "specify_cli/bundled_extensions/levelup"
32+
"extensions/architect" = "specify_cli/bundled_extensions/architect"
33+
"extensions/quick" = "specify_cli/bundled_extensions/quick"
34+
"extensions/product" = "specify_cli/bundled_extensions/product"
35+
"presets/agentic-sdlc" = "specify_cli/bundled_presets/agentic-sdlc"
36+
37+
[tool.hatch.build.targets.sdist]
38+
include = [
39+
"src/",
40+
"extensions/levelup/",
41+
"extensions/architect/",
42+
"extensions/quick/",
43+
"extensions/product/",
44+
"presets/agentic-sdlc/",
45+
]
46+
3047
[project.optional-dependencies]
3148
test = [
3249
"pytest>=7.0",

0 commit comments

Comments
 (0)