Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -127,4 +127,4 @@ jobs:
run: node scripts/copy-rust-binaries.mjs

- name: Validate specs
run: node bin/lean-spec.js validate --warnings-only
run: node bin/leanspec.js validate --warnings-only
10 changes: 5 additions & 5 deletions .github/workflows/copilot-setup-steps.yml
Original file line number Diff line number Diff line change
Expand Up @@ -58,13 +58,13 @@ jobs:
- name: Copy binaries to packages
run: node scripts/copy-rust-binaries.mjs

- name: Install lean-spec CLI globally
- name: Install leanspec CLI globally
run: npm install -g .
working-directory: packages/cli

- name: Verify lean-spec installation
- name: Verify leanspec installation
run: |
echo "lean-spec version:"
lean-spec --version
echo "leanspec version:"
leanspec --version
echo ""
echo "lean-spec is now available globally for Copilot coding agent to use"
echo "leanspec is now available globally for Copilot coding agent to use"
16 changes: 8 additions & 8 deletions .github/workflows/publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -169,11 +169,11 @@ jobs:
mkdir -p dist/${{ matrix.platform }}

if [ "${{ runner.os }}" = "Windows" ]; then
cp rust/target/${{ matrix.target }}/release/lean-spec.exe dist/${{ matrix.platform }}/
cp rust/target/${{ matrix.target }}/release/leanspec.exe dist/${{ matrix.platform }}/
cp rust/target/${{ matrix.target }}/release/leanspec-mcp.exe dist/${{ matrix.platform }}/
cp rust/target/${{ matrix.target }}/release/leanspec-http.exe dist/${{ matrix.platform }}/
else
cp rust/target/${{ matrix.target }}/release/lean-spec dist/${{ matrix.platform }}/
cp rust/target/${{ matrix.target }}/release/leanspec dist/${{ matrix.platform }}/
cp rust/target/${{ matrix.target }}/release/leanspec-mcp dist/${{ matrix.platform }}/
cp rust/target/${{ matrix.target }}/release/leanspec-http dist/${{ matrix.platform }}/
fi
Expand Down Expand Up @@ -291,7 +291,7 @@ jobs:

- name: Ensure CLI binaries are executable
run: |
chmod +x packages/cli/binaries/linux-x64/lean-spec || true
chmod +x packages/cli/binaries/linux-x64/leanspec || true

- name: Auto-bump dev version
if: ${{ github.event_name == 'workflow_dispatch' && inputs.dev }}
Expand Down Expand Up @@ -368,7 +368,7 @@ jobs:

- name: Validate specs
if: ${{ github.event_name != 'workflow_dispatch' || !inputs.dry_run }}
run: node bin/lean-spec.js validate --warnings-only
run: node bin/leanspec.js validate --warnings-only

- name: Prepare packages for npm publish
if: ${{ github.event_name != 'workflow_dispatch' || !inputs.dry_run }}
Expand Down Expand Up @@ -406,15 +406,15 @@ jobs:
echo "✅ Dev version published successfully"
echo ""
echo "Test installation:"
echo " npm install -g lean-spec@dev"
echo " npm install -g leanspec@dev"
exit 0
fi

echo "✅ Published main packages successfully"
echo ""
echo "Verify installation:"
echo " npm install -g lean-spec@latest"
echo " lean-spec --version"
echo " npm install -g leanspec@latest"
echo " leanspec --version"

- name: Verify publish success
run: |
Expand All @@ -429,7 +429,7 @@ jobs:
echo " - UI"
echo ""
echo "Users can now install with:"
echo " npm install -g lean-spec"
echo " npm install -g leanspec"

# Step 4: Build and publish Docker image (AFTER npm packages are live)
docker:
Expand Down
11 changes: 4 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,22 +87,19 @@ Works with any AI coding assistant via MCP or CLI:
Teach your AI assistant the Spec-Driven Development methodology:

```bash
# Recommended (uses skills.sh)
lean-spec skill install

# Or directly via skills.sh
npx skills add codervisor/lean-spec -y
# Install the leanspec skill
npx skills add codervisor/skills@leanspec
```

This installs the **leanspec-sdd** skill which teaches AI agents:
This installs the **leanspec** skill which teaches AI agents:
- When to create specs vs. implement directly
- How to discover existing specs before creating new ones
- Best practices for context economy and progressive disclosure
- Complete SDD workflow (Discover → Design → Implement → Validate)

**Compatible with:** Claude Code, Cursor, Windsurf, GitHub Copilot, and other [Agent Skills](https://skills.sh/) compatible tools.

📖 [View skill documentation →](skills/leanspec-sdd/SKILL.md)
📖 [Skill source →](https://github.com/codervisor/skills)

---

Expand Down
3 changes: 2 additions & 1 deletion bin/lean-spec.js
Original file line number Diff line number Diff line change
@@ -1,2 +1,3 @@
#!/usr/bin/env node
import '../packages/cli/bin/lean-spec-rust.js';
console.error('\x1b[33m⚠ "lean-spec" is deprecated. Use "leanspec" instead.\x1b[0m');
import '../packages/cli/bin/leanspec-rust.js';
2 changes: 2 additions & 0 deletions bin/leanspec.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
#!/usr/bin/env node
import '../packages/cli/bin/leanspec-rust.js';
11 changes: 5 additions & 6 deletions docs-site/docs/guide/migration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -320,11 +320,10 @@ AGENTS.md (in project root)
LeanSpec supports **Agent Skills** via SKILL.md. This lets you keep AGENTS.md short and project-specific.

**Recommended steps:**
1. Install the skill via `lean-spec skill install`
2. Use the installed SKILL.md at .github/skills/leanspec-sdd/
3. Reduce AGENTS.md to project-specific rules only (<100 lines)
4. Add a short note in AGENTS.md that references the skill
5. Commit the skill folder so it is shareable
1. Install the skill: `npx skills add codervisor/skills@leanspec`
2. Reduce AGENTS.md to project-specific rules only (<100 lines)
3. Add a short note in AGENTS.md that references the skill
4. Commit the skill folder so it is shareable

**Minimal AGENTS.md example:**

Expand All @@ -333,7 +332,7 @@ LeanSpec supports **Agent Skills** via SKILL.md. This lets you keep AGENTS.md sh

## Project: Your Project

Core SDD workflow is defined in .github/skills/leanspec-sdd/SKILL.md.
Install SDD skill: `npx skills add codervisor/skills@leanspec`

## Project-Specific Rules
- Use pnpm instead of npm
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ LeanSpec now supports **Agent Skills** via a SKILL.md file. This is the preferre

**Project skill location:**

- .github/skills/leanspec-sdd/SKILL.md (installed via `lean-spec skill install`)
- Install via: `npx skills add codervisor/skills@leanspec`

**Why use a skill?**
- Cross-platform: works with Claude, Cursor, Codex, and other skill-compatible tools
Expand All @@ -37,7 +37,7 @@ LeanSpec now supports **Agent Skills** via a SKILL.md file. This is the preferre

## Project: Example

Core SDD workflow is defined in .github/skills/leanspec-sdd/SKILL.md.
Install SDD skill: `npx skills add codervisor/skills@leanspec`

## Project-Specific Rules
- Use pnpm instead of npm
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -320,11 +320,10 @@ AGENTS.md(在项目根目录)
LeanSpec 支持通过 SKILL.md 提供 **Agent Skills**。这样 AGENTS.md 可以保持精简,仅包含项目特定规则。

**推荐步骤:**
1. 通过 `lean-spec skill install` 安装 Skill
2. 使用安装后的 SKILL.md:.github/skills/leanspec-sdd/
3. 将 AGENTS.md 缩减为项目特定规则(<100 行)
4. 在 AGENTS.md 中添加指向 skill 的简短说明
5. 提交 skill 目录便于共享
1. 安装 skill:`npx skills add codervisor/skills@leanspec`
2. 将 AGENTS.md 缩减为项目特定规则(<100 行)
3. 在 AGENTS.md 中添加指向 skill 的简短说明
4. 提交 skill 目录便于共享

**最小化 AGENTS.md 示例:**

Expand All @@ -333,7 +332,7 @@ LeanSpec 支持通过 SKILL.md 提供 **Agent Skills**。这样 AGENTS.md 可以

## 项目:Your Project

核心 SDD 工作流定义在 .github/skills/leanspec-sdd/SKILL.md。
安装 SDD skill:`npx skills add codervisor/skills@leanspec`

## 项目特定规则
- 使用 pnpm 而非 npm
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ LeanSpec 现在支持 **Agent Skills** 的 SKILL.md 文件。推荐将 **SDD 方

**项目级 Skill 位置:**

- .github/skills/leanspec-sdd/SKILL.md(通过 `lean-spec skill install` 安装)
- 安装:`npx skills add codervisor/skills@leanspec`

**为什么使用 Skill?**
- 跨平台:可用于 Claude、Cursor、Codex 等支持 Skills 的工具
Expand All @@ -37,7 +37,7 @@ LeanSpec 现在支持 **Agent Skills** 的 SKILL.md 文件。推荐将 **SDD 方

## 项目:Example

核心 SDD 工作流定义在 .github/skills/leanspec-sdd/SKILL.md。
安装 SDD skill:`npx skills add codervisor/skills@leanspec`

## 项目特定规则
- 使用 pnpm 而非 npm
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,6 @@
"validate-binaries": "tsx scripts/validate-platform-binaries.ts",
"publish:platforms": "tsx scripts/publish-platform-packages.ts",
"publish:main": "tsx scripts/publish-main-packages.ts",
"cli": "node bin/lean-spec.js"
"cli": "node bin/leanspec.js"
}
}
13 changes: 6 additions & 7 deletions packages/cli/bin/lean-spec.js
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
#!/usr/bin/env node
/**
* LeanSpec CLI Entry Point
*
* Thin wrapper that delegates to the Rust binary.
* The TypeScript implementation has been deprecated in favor of Rust.
*
* @see spec 181-typescript-deprecation-rust-migration
* LeanSpec CLI (deprecated entry point)
*
* The `lean-spec` command has been renamed to `leanspec`.
* This wrapper shows a deprecation notice and delegates to the new entry point.
*/
import './lean-spec-rust.js';
console.error('\x1b[33m⚠ "lean-spec" is deprecated. Use "leanspec" instead.\x1b[0m');
import './leanspec-rust.js';
Loading
Loading