teamspec 3.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TeamSpec Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,252 @@
+# TeamSpec CLI
+
+> Bootstrap TeamSpec 2.0 Feature Canon Operating Model in any repository
+
+[![npm version](https://img.shields.io/npm/v/teamspec.svg)](https://www.npmjs.com/package/teamspec)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## What is TeamSpec?
+
+TeamSpec is a **Feature Canon Operating Model** for software teams. It provides:
+
+- **Feature Canon** — Single source of truth for system behavior
+- **Delta-based Stories** — Stories describe changes, not full behavior
+- **Role-based Workflows** — Clear ownership boundaries (BA, FA, SA, DEV, QA, SM)
+- **AI Agent Integration** — Works with GitHub Copilot, Cursor, Claude, and more
+
+## Installation
+
+### Global Install (Recommended)
+
+```bash
+npm install -g teamspec
+```
+
+### npx (No Install)
+
+```bash
+npx teamspec
+```
+
+## Quick Start
+
+### Interactive Setup
+
+```bash
+cd your-repo
+teamspec
+```
+
+The CLI will ask:
+1. Your team profile (startup, enterprise, regulated, etc.)
+2. Organization and team name
+3. Industry sector
+4. Development cadence (scrum, kanban, scrumban)
+5. Initial project ID
+
+### Non-Interactive Setup
+
+```bash
+teamspec --profile startup --org "My Company" --team "Web Team" -y
+```
+
+## What Gets Created
+
+```
+your-repo/
+├── .teamspec/                    # Core framework
+│   ├── templates/                # Document templates
+│   ├── definitions/              # DoR/DoD checklists
+│   ├── profiles/                 # Profile overlays
+│   └── context/
+│       └── team.yml              # Your team configuration
+├── .github/
+│   └── copilot-instructions.md   # GitHub Copilot guidance (optional)
+├── projects/main-project/        # Project artifacts
+│   ├── features/                 # Feature Canon (source of truth)
+│   │   ├── features-index.md     # Feature registry
+│   │   └── story-ledger.md       # Completed story tracking
+│   ├── stories/                  # User stories
+│   │   ├── backlog/              # New stories
+│   │   ├── ready-to-refine/      # Ready for dev refinement
+│   │   └── ready-for-development/# Ready for sprint
+│   ├── adr/                      # Architecture decisions
+│   ├── decisions/                # Business decisions
+│   ├── dev-plans/                # Development task breakdowns
+│   ├── qa/                       # Test cases
+│   ├── sprints/                  # Sprint management
+│   └── epics/                    # Epic specifications
+
+```
+
+## Commands
+
+### Initialize TeamSpec
+
+```bash
+teamspec [init] [options]
+```
+
+**Options:**
+
+| Option | Description |
+|--------|-------------|
+| `-t, --target <dir>` | Target directory (default: current) |
+| `-p, --profile <profile>` | Team profile |
+| `-o, --org <name>` | Organization name |
+| `--team <name>` | Team name |
+| `--project <id>` | Project ID |
+| `--ide <ide>` | IDE integration (vscode, cursor, other, none) |
+| `--copilot <yes\|no>` | Install GitHub Copilot instructions (default: yes) |
+| `-y, --non-interactive` | Skip prompts, use defaults |
+
+### Update TeamSpec
+
+```bash
+teamspec update [options]
+```
+
+Updates templates, definitions, and profiles while preserving your team configuration.
+
+**Options:**
+
+| Option | Description |
+|--------|-------------|
+| `-f, --force` | Update without confirmation |
+| `-y, --non-interactive` | Skip confirmation prompt |
+
+## Profiles
+
+| Profile | Description |
+|---------|-------------|
+| `none` | Vanilla TeamSpec |
+| `startup` | Lean documentation, speed focus |
+| `platform-team` | API-first, SLA focus |
+| `enterprise` | Full governance, audit trails |
+| `regulated` | Banking, healthcare, government compliance |
+
+## TeamSpec Commands (for AI Agents)
+
+Once configured, use these commands with your AI assistant:
+
+### Business Analysis
+
+```
+ts:ba create     # Create business analysis
+ts:ba feature    # Propose and create features
+ts:ba epic       # Propose epics with justification
+```
+
+### Functional Analysis
+
+```
+ts:fa story      # Create user story
+ts:fa slice      # Slice requirements into stories
+ts:fa sync       # Update Feature Canon after story completion
+```
+
+### Development
+
+```
+ts:dev plan      # Create development plan
+ts:dev implement # Execute from existing plan
+```
+
+### Quality Assurance
+
+```
+ts:qa test       # Design test cases
+ts:qa bug        # File bug report
+ts:qa uat        # Create UAT pack
+```
+
+### Scrum Master
+
+```
+ts:sm sprint create  # Create new sprint
+ts:sm sprint status  # View sprint status
+ts:sm sprint close   # Close sprint with metrics
+```
+
+## Key Concepts
+
+### Feature Canon
+
+The Feature Canon is the **single source of truth** for system behavior. It lives in `projects/<project-id>/features/` and contains:
+
+- **Feature Files** — Define what the system does
+- **Features Index** — Registry of all features
+- **Story Ledger** — Tracks how features evolved through stories
+
+### Delta-based Stories
+
+Stories describe **changes** (deltas) to the Feature Canon, not full behavior:
+
+```markdown
+### Before (current behavior)
+Reference: F-001, Section: User Registration
+
+### After (new behavior)
+Email confirmation is now optional for OAuth users.
+```
+
+### Workflow Folders
+
+Stories move through workflow folders:
+
+1. `stories/backlog/` — FA creates new stories here
+2. `stories/ready-to-refine/` — FA moves stories ready for dev refinement
+3. `stories/ready-for-development/` — DEV moves refined stories here
+4. Sprint — SM assigns to active sprint
+
+## Configuration
+
+Edit `.teamspec/context/team.yml` to customize:
+
+```yaml
+org:
+  name: "Your Organization"
+  industry: technology
+  profile: startup
+
+team:
+  name: "Your Team"
+  roles: [BA, FA, DEV, QA, SM]
+  cadence:
+    type: scrum
+    sprint_length_days: 14
+
+tech:
+  stack:
+    - Python
+    - React
+    - PostgreSQL
+
+governance:
+  sign_off_required: false
+  audit_trail: false
+```
+
+## Development
+
+### Local Testing
+
+```bash
+cd cli
+npm link
+teamspec --help
+```
+
+### Running Tests
+
+```bash
+npm test
+```
+
+## License
+
+MIT
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

package/bin/teamspec-init.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+/**
+ * TeamSpec Init CLI
+ * Bootstrap TeamSpec 2.0 Feature Canon operating model in any repository
+ */
+
+const { run } = require('../lib/cli');
+
+run(process.argv.slice(2));