Skip to content

virkt25/sniper

Repository files navigation

SNIPER

AI-Powered Project Lifecycle Framework

SNIPER is a framework for orchestrating Claude Code agent teams through structured project lifecycle phases. It provides personas, team compositions, workflows, and slash commands that coordinate parallel AI agents to build software from discovery through deployment.

Documentation

How It Works

SNIPER breaks projects into protocol-driven phases, orchestrated by /sniper-flow:

  1. Discover — Agents analyze requirements, codebase, and constraints
  2. Define — Product manager produces the PRD and requirements specification
  3. Design — Architect produces system architecture aligned with the PRD
  4. Solve — Stories are sharded into implementable units with acceptance criteria
  5. Implement — Parallel agents build in isolated worktrees with file ownership boundaries
  6. Review — Quality gates validate phase outputs before advancing
  7. Retro — Learnings are captured and codified into project memory

Each protocol defines which phases to run (e.g., full runs all seven, patch skips to implement + review). Agents are composed from layered personas (cognitive style, role, domain knowledge) and assigned tasks with ownership boundaries.

Packages

Package npm Description
@sniper.ai/core @sniper.ai/core Framework core — agents, personas, skills, protocols, checklists, templates, hooks, and schemas
@sniper.ai/cli @sniper.ai/cli CLI tool — scaffolds and manages SNIPER-enabled projects
@sniper.ai/mcp-knowledge @sniper.ai/mcp-knowledge MCP server for domain knowledge indexing and retrieval
@sniper.ai/plugin-typescript @sniper.ai/plugin-typescript TypeScript language plugin — commands, conventions, review checks, agent mixins
@sniper.ai/plugin-python @sniper.ai/plugin-python Python language plugin — commands, conventions, review checks, agent mixins
@sniper.ai/plugin-go @sniper.ai/plugin-go Go language plugin — commands, conventions, review checks, agent mixins
@sniper.ai/pack-sales-dialer @sniper.ai/pack-sales-dialer Example domain pack — sales dialer SaaS domain knowledge

Quick Start

# Install the CLI
npm install -g @sniper.ai/cli

# Initialize SNIPER in your project
cd your-project
sniper init

# Start a protocol in Claude Code
/sniper-flow

Development

Prerequisites

  • Node.js >= 18
  • pnpm >= 9

Setup

git clone https://github.com/virkt25/sniper.git
cd sniper
pnpm install
pnpm build

Commands

pnpm build          # Build all packages
pnpm dev            # Watch mode for all packages
pnpm clean          # Clean dist directories
pnpm lint           # Lint all packages
pnpm changeset      # Create a changeset for versioning
pnpm release        # Build + publish with changesets

Project Structure

sniper/
├── packages/
│   ├── core/                       # Framework content (YAML/Markdown, no build)
│   │   ├── agents/                 # Agent definitions
│   │   ├── personas/               # Persona layers (cognitive, process, technical)
│   │   ├── skills/                 # Slash command definitions
│   │   ├── protocols/              # Protocol state machines
│   │   ├── templates/              # Artifact templates
│   │   ├── checklists/             # Quality gate checklists
│   │   ├── hooks/                  # Claude Code hook definitions
│   │   └── schemas/                # Runtime data schemas
│   ├── cli/                        # CLI tool (sniper binary)
│   │   └── src/commands/           # CLI subcommands
│   ├── mcp-knowledge/              # MCP server for knowledge retrieval
│   │   └── src/
│   ├── plugins/
│   │   ├── plugin-typescript/      # TypeScript language plugin
│   │   ├── plugin-python/          # Python language plugin
│   │   └── plugin-go/              # Go language plugin
│   ├── pack-sales-dialer/          # Example domain pack
│   └── docs/                       # Documentation site (Vitepress)
├── docs/
└── plans/

Domain Packs

Domain packs inject project-specific knowledge into SNIPER agents. They provide context files (telephony, CRM, compliance, etc.) that agents reference during planning and implementation. See @sniper.ai/pack-sales-dialer for an example.

sniper add-pack @sniper.ai/pack-sales-dialer

Documentation

Full documentation is available at sniperai.dev.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors