Skip to main content

SpecWeave Features & Capabilities

Version: 0.26.x Last Updated: 2025-11-24

Comprehensive overview of what SpecWeave supports.

Status Legend​

StatusMeaning
ProductionStable, fully supported
BetaFeature complete, collecting feedback
AlphaIn development, may change
PlannedOn roadmap, not started

Core Features​

Spec-Driven Development​

FeatureStatusDescription
Three-file structureProductionspec.md, plan.md, tasks.md per increment
AI-generated specsProductionPM Agent creates user stories, ACs
Architecture decisionsProductionADRs auto-generated by Architect Agent
Embedded testsProductionBDD tests in tasks.md
Living documentationProductionAuto-sync after task completion

Increment Management​

FeatureStatusDescription
WIP limitsProductionFocus on 1 active increment (hard cap: 2)
Status transitionsProductionplanned → active → done/paused/abandoned
PM validation gatesProductionQuality checks before closure
Auto-archiveProductionCompleted increments move to _archive
Increment typesProductionfeature, hotfix, bug, change-request, refactor, experiment

Initialization​

FeatureStatusDescription
Strategic InitProduction6-phase research-driven setup (10-15 min)
Vision & MarketProductionProduct analysis, competitor detection
Compliance DetectionProduction30+ standards (HIPAA, SOC2, GDPR, PCI-DSS...)
Team RecommendationsProductionSize, roles, cost estimates
Multi-repo SelectionProductionConfigure multiple repositories
Brownfield SupportProductionImport existing projects

External Integrations​

Issue Trackers​

PlatformStatusFeatures
GitHub IssuesProductionThree-permission sync, multi-repo, profiles
JIRAProductionEpic/Story hierarchy, sprints, labels
Azure DevOpsProductionWork items, area paths, iterations
LinearPlannedIssue sync (Q1 2026)

Sync Capabilities​

FeatureStatusDescription
Three-Permission ArchitectureProductioncanUpsertInternal, canUpdateExternal, canUpdateStatus
Profile-based syncProductionMultiple repos per project
Time range filteringProduction1W, 1M, 3M, 6M, ALL
Rate limit protectionProductionSmart backoff
Duplicate detectionProductionPrevents duplicate issues

AI Agents​

Strategic Layer​

AgentStatusCapabilities
PM AgentProductionUser stories, prioritization, market research
Architect AgentProductionSystem design, ADRs, tech stack

Execution Layer​

AgentStatusCapabilities
Tech Lead AgentProductionImplementation planning, code review
Backend AgentsProductionNode.js, Python, .NET implementation
Frontend AgentProductionReact, Next.js, Vue, Angular
Mobile AgentProductionReact Native architecture

Quality Layer​

AgentStatusCapabilities
QA Lead AgentProductionTest strategy, coverage planning
Security AgentProductionThreat modeling, compliance
DevOps AgentProductionInfrastructure, CI/CD
SRE AgentProductionIncident response, runbooks

Specialty Agents​

AgentStatusCapabilities
Data Scientist AgentProductionML pipelines, analytics
Database Optimizer AgentProductionQuery optimization
Performance AgentProductionProfiling, optimization
Kafka Architect AgentProductionEvent streaming design

Skills (Auto-Activating)​

Core Skills​

SkillActivation Keywords
increment"plan increment", "new feature", "build"
spec-generator"spec", "requirements", "user stories"
brownfield-analyzer"existing project", "legacy", "migrate"
tdd-workflow"TDD", "test-driven", "red-green"
serverless-recommender"serverless", "Lambda", "Azure Functions"

Integration Skills​

SkillActivation Keywords
external-sync-wizard"sync GitHub", "JIRA integration"
compliance-architecture"HIPAA", "SOC2", "GDPR"
roadmap-planner"roadmap", "prioritization", "RICE"

Commands​

Increment Commands​

CommandPurpose
/specweave:increment "title"Create new increment
/specweave:doExecute implementation
/specweave:done 0001Complete with validation
/specweave:progressShow all increment status
/specweave:validate 0001Quality check
/specweave:pause 0001Pause increment
/specweave:resume 0001Resume increment
/specweave:abandon 0001Abandon increment
/specweave:reopen 0001Reopen completed increment

Sync Commands​

CommandPurpose
/specweave:sync-progressFull multi-system sync
/specweave:sync-docsSync to living docs
/specweave-github:sync 0001Sync to GitHub
/specweave-github:create-issue 0001Create GitHub issue
/specweave-github:close-issue 0001Close GitHub issue
/specweave-jira:syncSync to JIRA
/specweave-ado:syncSync to Azure DevOps

Quality Commands​

CommandPurpose
/specweave:qa 0001Run quality assessment
/specweave:check-testsValidate test coverage
/specweave:tdd-cycleFull TDD workflow
/specweave:tdd-redWrite failing tests
/specweave:tdd-greenMake tests pass
/specweave:tdd-refactorRefactor with safety

Import/Export Commands​

CommandPurpose
/specweave:import-docsImport from Notion, Confluence, Wiki
/specweave:import-externalImport from issue trackers
/specweave:translateTranslate project content

Hooks​

HookEventDefault Actions
post-increment-planningAfter /specweave:incrementCreate GitHub issue, translate
post-task-completionAfter task completeSync docs, update external
post-increment-doneAfter /specweave:doneClose issue, archive
pre-implementationBefore /specweave:doValidate environment

Documentation Features​

Living Docs​

FeatureStatusDescription
Auto-syncProductionDocs update on task completion
Content classificationProduction9 categories auto-detected
Project detectionProductionbackend/frontend/mobile routing
Cross-linkingProductionInter-document links
Docusaurus frontmatterProductionAuto-generated YAML

Document Types​

TypeLocationAuto-generated
User Storiesspecs/{project}/Yes
ADRsarchitecture/adr/Yes
Runbooksoperations/Yes
SLOsoperations/Yes
Test Strategiesdelivery/Yes

Configuration​

Config File (.specweave/config.json)​

{
  "sync": {
    "enabled": true,
    "activeProfile": "my-project",
    "settings": {
      "canUpsertInternalItems": true,
      "canUpdateExternalItems": true,
      "canUpdateStatus": true
    },
    "profiles": {
      "my-project": {
        "provider": "github",
        "config": { "owner": "org", "repo": "repo" }
      }
    }
  },
  "hooks": {
    "post_task_completion": {
      "sync_living_docs": true,
      "external_tracker_sync": true
    }
  },
  "limits": {
    "maxActiveIncrements": 1,
    "hardCap": 2
  }
}

Environment Variables​

VariablePurpose
GITHUB_TOKENGitHub API authentication
JIRA_TOKENJIRA API authentication
AZURE_DEVOPS_PATAzure DevOps authentication
SPECWEAVE_DISABLE_HOOKSEmergency hook disable

Plugin Ecosystem​

Official Plugins​

PluginFocus
specweaveCore (PM, Architect, 22 agents)
specweave-githubGitHub Issues integration
specweave-jiraJIRA integration
specweave-adoAzure DevOps integration
specweave-mlMachine learning workflows
specweave-infrastructureDevOps, SRE, observability
specweave-kafkaKafka streaming architecture
specweave-releaseRelease management
specweave-diagramsMermaid diagram generation
specweave-frontendFrontend architecture
specweave-testingQA engineering
specweave-backendDatabase optimization
specweave-mobileMobile architecture
specweave-paymentsPayment integration
specweave-kubernetesK8s architecture
specweave-docsDocumentation & preview
specweave-toolingPlugin development

Supported Project Types​

By Stage​

TypeSupport Level
GreenfieldFull - Strategic Init guides from scratch
BrownfieldFull - Import existing docs, detect patterns

By Architecture​

ArchitectureSupport Level
MonolithFull
MicroservicesFull
MonorepoFull
Multi-repoFull
ServerlessFull

By Platform​

PlatformSupport Level
Web (SPA)Full
Web (SSR/SSG)Full
Mobile (React Native)Full
Backend (Node.js)Full
Backend (Python)Full
Backend (.NET)Full

Requirements​

RequirementVersion
Node.js20+
npm8+
Git2.x
Claude CodeRecommended

Roadmap​

FeatureTargetPriority
Linear integrationQ1 2026 (Jan-Mar)P0
Notion integrationQ2 2026 (Apr-Jun)P1
Slack notificationsQ2 2026 (Apr-Jun)P1
VS Code extensionQ3 2026 (Jul-Sep)P2
GitLab integrationQ3 2026 (Jul-Sep)P2