@trieungoctam/speckit 0.1.0

package/docs/development-roadmap.md

@@ -0,0 +1,30 @@
+# Development Roadmap
+
+## Current Status
+
+Speckit MVP is implemented and pushed to `git@github.com:trieungoctam/speckit.git` on `main`.
+
+Current package target: `@trieungoctam/speckit@0.1.0`.
+
+The CLI is npx-ready, generates Agile + TDD rules, creates workflow artifacts, supports five IDE adapters, wraps Beads Viewer safely, and has automated tests plus CI.
+
+## Milestones
+
+| Milestone | Status | Notes |
+| --- | --- | --- |
+| Product contract | Complete | Contract, workflow model, and command surface documented. |
+| CLI scaffold | Complete | `bin/speckit`, TypeScript build, command router, managed file writer. |
+| Workflow engine | MVP Complete | `shape`, `plan`, `quick`, `run`, and `review` generate usable artifacts. |
+| IDE adapters | Complete | Claude Code, Codex, Antigravity, OpenCode, Cursor. |
+| Beads integration | MVP Complete | `next` wraps BV robot mode; `sync` exports story metadata JSONL. |
+| Validation | Complete | Build and `node:test` suite pass locally. |
+| GitHub publish | Complete | Initial code pushed to `trieungoctam/speckit` at commit `7e5c582`; status docs follow-up in progress. |
+| npm package readiness | Ready | Package scoped as `@trieungoctam/speckit`; `npm pack --dry-run` passes. |
+
+## Next Roadmap
+
+- Publish `@trieungoctam/speckit` to npm.
+- Add GitHub trusted publishing for npm releases.
+- Add richer config loading from `.speckit/config.yaml`.
+- Add optional direct `br`/`bd` import once command compatibility is pinned.
+- Add snapshot tests for full adapter file contents.

package/docs/enterprise-rollout.md

@@ -0,0 +1,27 @@
+# Enterprise Rollout
+
+Speckit works best as a repo-local standard, then as an organization template.
+
+## Adoption Path
+
+1. Pilot in one service repository with `speckit init --ide all`.
+2. Require stories to include acceptance criteria and TDD evidence.
+3. Add `speckit doctor` and project tests to CI.
+4. Export stories with `speckit sync` for task graph visibility.
+5. Roll the generated adapter pack into team templates.
+
+## Governance Layers
+
+| Layer | Owner | Speckit Artifact |
+| --- | --- | --- |
+| Company policy | Engineering leadership | `.speckit/rules/enterprise-safety.md` |
+| Team workflow | Tech lead | `.speckit/workflows/*.md` |
+| Repo standard | Maintainers | `AGENTS.md`, `CLAUDE.md`, IDE config |
+| Story evidence | Implementer | `.speckit/evidence/*.md` |
+
+## Recommended Controls
+
+- Do not allow code stories to merge without red-green-refactor evidence.
+- Keep adapter output generated from Speckit instead of hand-maintaining per-IDE rules.
+- Treat `speckit doctor` warnings as rollout debt.
+- Use Beads Viewer only through robot commands for non-interactive automation.

package/docs/product-contract.md

@@ -0,0 +1,27 @@
+# Product Contract
+
+Speckit owns the workflow contract for enterprise Agile + TDD development with agentic IDEs.
+
+## Speckit Owns
+
+- The `.speckit/` source of truth: config, rules, workflows, templates, generated artifacts.
+- The command surface: `init`, `doctor`, `shape`, `plan`, `quick`, `next`, `sync`, `run`, `review`.
+- The TDD gate: code stories require red, green, and refactor evidence.
+- The adapter compiler for Claude Code, Codex, Antigravity, OpenCode, and Cursor.
+- The safety policy for destructive commands, secrets, production access, and review readiness.
+
+## Speckit Delegates
+
+- Implementation to the selected IDE and agent runtime.
+- Product lifecycle inspiration to BMad-style phases, without copying BMad personas or branding.
+- Execution orchestration inspiration to ClaudeKit-style plan/cook/test/review flows.
+- Task graph prioritization to beads and Beads Viewer robot commands.
+- Git, tests, CI, and deployment to project-local tooling.
+
+## State Model
+
+```text
+intake -> shaped -> planned -> sliced -> spec-ready -> tests-red -> running -> tests-green -> refactor -> review-ready -> closed
+```
+
+Implementation starts only after a story is spec-ready. Review starts only after test evidence exists.

package/docs/project-changelog.md

@@ -0,0 +1,33 @@
+# Project Changelog
+
+## 2026-05-10
+
+### Added
+
+- Created Speckit TypeScript CLI package.
+- Scoped npm package metadata as `@trieungoctam/speckit`.
+- Added GitHub repository metadata for `trieungoctam/speckit`.
+- Added GitHub Actions CI for lint, test, and package dry-run checks.
+- Added `init`, `doctor`, `shape`, `quick`, `plan`, `next`, `sync`, `run`, and `review` commands.
+- Added managed-file generation with overwrite protection.
+- Added native adapter generation for Claude Code, Codex, Antigravity, OpenCode, and Cursor.
+- Added Beads Viewer-safe `next` command using robot mode only.
+- Added story-to-JSONL sync artifact for beads integration.
+- Added product, workflow, adapter, enterprise rollout, roadmap, and release docs.
+- Added automated tests for adapters, managed files, init, workflow artifacts, sync, and test detection.
+
+### Validation
+
+- `bin/speckit init --ide all` works in a temporary directory.
+- `npm run build` passes.
+- `npm run lint` passes.
+- `npm test` passes with 13 tests.
+- `npm pack --dry-run` passes.
+
+### Published
+
+- Initial commit pushed to `git@github.com:trieungoctam/speckit.git` on `main`.
+
+### Fixed
+
+- Fixed `bin/speckit` so package binary invokes `main()` correctly when installed through npm/npx.

package/docs/release-checklist.md

@@ -0,0 +1,20 @@
+# Release Checklist
+
+Before publishing Speckit:
+
+- [x] `npm run build` passes.
+- [x] `npm run lint` passes.
+- [x] `npm test` passes.
+- [x] `bin/speckit init --ide all` works in a temporary directory.
+- [x] `npm pack --dry-run` includes only package-safe files.
+- [x] `package.json` name is `@trieungoctam/speckit` and `publishConfig.access` is `public`.
+- [x] README uses `npx @trieungoctam/speckit@latest`.
+- [x] Adapter output paths match `docs/adapters.md`.
+- [x] Cursor output uses `.cursor/rules/*.mdc`, not `.cursorrules`.
+- [x] `speckit next` only invokes `bv --robot-*`.
+- [ ] License and attribution review is complete for ClaudeKit, BMad Method, and Beads Viewer inspiration.
+- [x] README quickstart is accurate.
+- [x] No secrets, local credentials, or generated private data are included.
+- [x] Initial code pushed to `git@github.com:trieungoctam/speckit.git`.
+- [ ] npm package published.
+- [ ] GitHub trusted publishing configured for npm releases.

package/docs/system-architecture.md

@@ -0,0 +1,27 @@
+# System Architecture
+
+```text
+bin/speckit
+  -> dist/cli.js
+  -> src/commands/*
+  -> src/core/*
+  -> src/adapters/*
+```
+
+## Modules
+
+- `src/cli.ts`: parses command line input and routes commands.
+- `src/commands/*`: command implementations with filesystem-safe outputs.
+- `src/core/managed-files.ts`: creates or updates only Speckit-managed files unless forced.
+- `src/core/scaffold.ts`: defines core `.speckit/` rules, workflows, and templates.
+- `src/core/test-detection.ts`: detects project test commands for TDD evidence.
+- `src/adapters/*`: renders native IDE config and instruction packs.
+- `src/adapters/tool-checks.ts`: reports external tool availability.
+
+## Data Flow
+
+```text
+user intent -> CLI command -> markdown/json artifact -> IDE adapter -> agent workflow
+```
+
+The CLI does not depend on running ClaudeKit, BMad, or Beads code. External tools are optional integrations discovered at runtime.

package/docs/workflow-model.md

@@ -0,0 +1,49 @@
+# Workflow Model
+
+Speckit exposes two primary lanes.
+
+## Quick Lane
+
+Use for a bounded change.
+
+```bash
+speckit quick "Add invoice validation"
+speckit run .speckit/stories/<story>.md
+speckit review
+```
+
+Outputs:
+
+- `.speckit/stories/<story>.md`
+- `.speckit/evidence/<story>-tdd-evidence.md`
+
+## Full Lane
+
+Use for product or enterprise rollout work.
+
+```bash
+speckit shape "Standardize Agile + TDD across teams"
+speckit plan "Standardize Agile + TDD across teams"
+speckit sync
+speckit next
+```
+
+Outputs:
+
+- `.speckit/specs/*.md`
+- `.speckit/plans/<plan>/prd.md`
+- `.speckit/plans/<plan>/architecture.md`
+- `.speckit/plans/<plan>/story.md`
+- `.speckit/plans/<plan>/tdd-evidence.md`
+- `.speckit/sync/beads-sync.jsonl`
+
+## TDD Evidence Gate
+
+Each code story must record:
+
+- Test intent
+- Red command and result
+- Green command and result
+- Refactor command and result
+
+Missing evidence means the story is not review-ready.

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@trieungoctam/speckit",
+  "version": "0.1.0",
+  "description": "Enterprise Agile + TDD workflow compiler for agentic IDEs.",
+  "type": "module",
+  "files": [
+    "bin",
+    "dist",
+    "docs",
+    "README.md"
+  ],
+  "bin": {
+    "speckit": "bin/speckit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/trieungoctam/speckit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/trieungoctam/speckit/issues"
+  },
+  "homepage": "https://github.com/trieungoctam/speckit#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test $(find tests -name '*.test.js' -type f | sort)",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "prepare": "npm run build",
+    "speckit": "npm run build --silent && node ./dist/cli.js"
+  },
+  "keywords": [
+    "agile",
+    "tdd",
+    "agentic-ide",
+    "claude-code",
+    "codex",
+    "cursor",
+    "opencode",
+    "antigravity"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0"
+  }
+}