wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About
  • What is WinGet?

© 2026 winget.ragerworks.com

Loading...
  1. Go back
  2. Packages
  3. DogdouSpec
DogdouSpec logo

DogdouSpec Hangzhou Xueyehu Technology Co., Ltd.

ai cli dotnet governance specification task-management
Use this command to install DogdouSpec with WinGet:
winget install --id=Vixasol.DogdouSpec -e

DogdouSpec provides an iteration-first specification and task governance engine designed to keep multi-step, complex engineering tasks structured, token-efficient, and resilient across AI coding sessions.

README

DogdouSpec

DogdouSpec is an iteration-first structured XML/XPath specification and technical execution engine designed for human and AI pairing.

Publisher and Support

DogdouSpec is published by Hangzhou Xueyehu Technology Co., Ltd. The company hosts the project's source code and releases under its GitHub organization, XueYeHuLabs. The Vixasol namespace in the WinGet package identifier Vixasol.DogdouSpec comes from the vixasol.com domain; it is not a separate publisher. The official publisher identity page documents the relationship between the legal publisher, the namespace, and the GitHub organization.

  • Project source and releases: XueYeHuLabs/dogdouspec.
  • Support and issue reports: GitHub Issues.
  • Privacy: DogdouSpec Privacy Policy.
  • License: MIT.

1. Quick Start & Adoption Guide

Standard Global Installation (Recommended for Most Projects)

For standard development environments with a global package manager:

  1. Install DogdouSpec globally on Windows: 
    winget install Vixasol.DogdouSpec
  2. Initialize workspace in your repository: Navigate to your project root and run: 
    dogdouspec workspace init
    This single command performs all mechanical initialization:
    • Creates .dogdouspec/ with authoritative XSD schemas, backlog.xml, and knowledge.xml.
    • Copies the agent skill to .agents/skills/dogdouspec/ (SKILL.md + references). Skips files that already exist.
    • Appends /.dogdouspec/_tmp/ to .gitignore (idempotent; creates the file if not present).
  3. Read the setup guide and configure your project: 
    dogdouspec skill guide
    The guide describes what to add to AGENTS.md, what to commit to Git, and how to tailor DogdouSpec to your project's build tools. These are agent + owner decisions — DogdouSpec never writes AGENTS.md automatically.
  4. Checkpoint the initialized governed state in Git-backed repositories:
    • Managed .dogdouspec/ documents and .agents/skills/dogdouspec/ are authoritative project state. Review and commit them explicitly.
    • DogdouSpec does not run git add, git commit, or git push. Inspect git status --short -- .dogdouspec and create a checkpoint only with repository-write authority.

Upgrading DogdouSpec

After installing a newer version:

winget upgrade Vixasol.DogdouSpec

# Read the new binary's authoritative workflow before changing the repository:
dogdouspec skill guide --all

The embedded upgrade contract requires read-only workspace, Skill, schema, and Git assessment before explicit mechanical synchronization. The calling agent then reconciles AGENTS.md, local guidance, wrappers, CI, and other repository-specific content. DogdouSpec never makes those judgment-based edits, stages files, commits, or pushes.

Air-Gapped & Source-Based Deployment (Repo-Local Vendoring)

For isolated, air-gapped, or hermetic environments where global tools, PATH modifications, or external package managers are prohibited:

  • Follow the authoritative Air-Gapped / Vendored Deployment Guide to compile a self-contained ~9.5 MB dogdouspec.exe into /tools/dogdouspec/ with a root dogdouspec.cmd wrapper.

2. Developer Build and Test (From Source)

  • .NET SDK 10.0.* (10.0.100 or compatible), target framework net10.0, C# 14.
  • System.CommandLine 2.0.11 for CLI parsing.
  • Built-in System.Xml, System.Xml.XPath, and XmlSchemaSet.
  • MSTest 4.0.2 for unit and integration testing.

Run the repository build and test script:

build.cmd

Or using the .NET CLI:

dotnet build DogdouSpec.slnx -c Debug
dotnet test DogdouSpec.slnx -c Debug --no-build

3. CLI Commands Reference

All commands run directly through dogdouspec [options]:

1. Workspace Commands

  • Workspace Discovery 
    dogdouspec workspace discover [--workspace-root PATH] [--format xml|human]
  • Workspace Initialization 
    dogdouspec workspace init [--workspace-root PATH] [--format xml|human]
    Initialization creates authoritative managed state. In Git-backed governed work, validate and checkpoint that state explicitly; the CLI never stages or commits it.
  • Workspace Unlock (release stale writer locks and run startup recovery) 
    dogdouspec workspace unlock [--force] [--workspace-root PATH] [--format xml|human]

2. Skill and Schema Upgrade Primitives

  • Skill Guide (authoritative guidance embedded in the current binary) 
    dogdouspec skill guide [--all] [--format markdown|human|xml]
  • Skill Status (read-only embedded-versus-repository comparison) 
    dogdouspec skill status [--output-dir PATH] [--format xml|human]
    Exit code 1 means differences were reported for caller review. It is not a command failure.
  • Skill Sync (synchronize skill files with this CLI's embedded version; pass --force to overwrite upon upgrade) 
    dogdouspec skill sync [--force] [--output-dir PATH] [--format xml|human]
    Requires --force to overwrite existing files. Never reads or modifies AGENTS.md. Agent and owner decide how to update AGENTS.md based on skill guide output.
  • Skill Export 
    dogdouspec skill export --output-dir PATH [--format xml|human]
  • Schema Status and Sync (inspect or mechanically refresh optional readable XSD copies) 
    dogdouspec schema status [--version 1.0] [--workspace-root PATH] [--format xml|human]
dogdouspec schema sync --expected-version 1.0 [--workspace-root PATH] [--format xml|human]
    schema sync uses the workspace writer lock and crash recovery. It never migrates or edits managed XML documents.

3. Iteration Commands

  • Iteration Listing 
    dogdouspec iteration list [--workspace-root PATH] [--format xml|human]
  • Iteration Creation (supports --activate for immediate active state) 
    dogdouspec iteration create --id YYYYMMDD-name --kind feature|research [--activate] [--workspace-root PATH] [--format xml|human]
  • Iteration Activation (Porcelain command) 
    dogdouspec iteration activate [--iteration ID] [--auto-approve] [--summary "..."] [--format xml|human]
  • Iteration Completion (Porcelain command) 
    dogdouspec iteration complete [--iteration ID] [--accept-all] [--summary "..."] [--format xml|human]
  • Iteration Readiness 
    dogdouspec iteration readiness --iteration ID --phase activation|completion [--workspace-root PATH] [--format xml|human]
  • Iteration Confirmation (Plumbing raw XML confirmation) 
    dogdouspec iteration confirm (--stdin|--file PATH) [--workspace-root PATH] [--format xml|human]

4. Validation & Query

  • Validation 
    dogdouspec validate [--workspace-root PATH] [--iteration ID] [--document RELATIVE_PATH] [--format xml|human]
  • XPath Query 
    dogdouspec query --document REF --xpath EXPR [--var name=value ...] [--workspace-root PATH] [--format xml|human]
  • Scoped Search 
    dogdouspec search --scope project|iteration [--iteration ID] --xpath EXPR [--var name=value ...] [--workspace-root PATH] [--format xml|human]

5. Task & Requirement Mutations

  • High-Level Task Operations:
    • task start --task [--iteration ] [--summary "..."] (Transition to in-progress)
    • task verify --task [--iteration ] [--covers ] [--summary "..."] (Transition to verification)
    • task finish --task [--iteration ] [--covers ] [--summary "..."] (Atomic completion to done)
    • task block --task --summary "..." [--blocker-kind ] [--blocker-owner ] [--blocker-review-at ] [--condition "..."] [--next-action "..."] (Transition to blocked with structured finding)
    • task resume --task (--finding | --all) --summary "..." (Resolve blocker findings and resume to in-progress)
    • task quick --title ... --scope ... --done-when ... --why ... [--start] (Quick-create task)
    • task next [--iteration ] (Discover next actionable task with progression assessment facts)
    • task blockers [--iteration ] [--task ] [--owner ] [--due-only] (Query active blockers and recheck queue)
    • task context --task [--iteration ] [--max-bytes ] [--no-history] (Query bounded, traceable task recovery context)
  • Plumbing & Governance Operations:
    • task update (Raw XML state machine update), task review (Review gate submission), task add, task revise, task split
    • requirement propose, change propose, change apply
    • backlog add, backlog list, backlog schedule, backlog complete, backlog cancel
    • append, transaction apply

6. Diagnostics & Reporting

  • Iteration Summary (instant progress card and task breakdown with progression assessment) 
    dogdouspec summary [--iteration ID] [--workspace-root PATH] [--format markdown|json|xml|human]
  • VCS Working Tree Status (read-only inspection of managed document cleanliness and checkpoint readiness) 
    dogdouspec workspace vcs-status [--workspace-root PATH] [--format xml|human]

4. Exit Codes

CodeMeaning
0Success, including a verified idempotent retry
1Read-only scope verification completed with one or more out-of-scope paths
2Command, XML request, XPath, or argument error
3Schema or semantic validation failure
4Revision, lock, cardinality, or idempotency conflict
5Protected product decision or authority gate
6Filesystem commit or recovery failure
7Input, query, projection, or output limit exceeded

5. Documentation & References

  • Air-Gapped & Vendored Deployment Guide: See docs/INSTALL_IN_OTHER_REPOSITORY.md for self-contained, source-based repo-local deployment in isolated environments.
  • Cross-Platform Build & Packaging: See docs/CROSS_PLATFORM.md for Linux and macOS compilation and packaging guidance.
  • Dogfood Remediation Evidence: See docs/DOGDOUCLIX_DOGFOOD_REMEDIATION.md for background analysis and remediation evidence.
  • Agent Guidelines & Skills: See AGENTS.md and .agents/skills/dogdouspec/SKILL.md for workflow integration rules and compact two-phase query patterns.
  • Usability, Results, and Checkpoint Proposal: See docs/DOGFOOD_USABILITY_AND_EVIDENCE_PROPOSAL.md for the merged non-normative roadmap. Proposed commands described there are not current CLI commands.

6. Architectural Boundaries & Workflow

  • Repository-Local State: Authoritative specification and task state is stored entirely within .dogdouspec/ XML documents and validated against embedded XSD v1 schemas.
  • Iteration-Owned Results: Implementation summaries, commits, checks, findings, reviews, risks, blockers, and handoff instructions are persisted in tasks.xml records. Raw agent reports, prompts, and provider logs are transient by default; only inherently bulky raw evidence remains external when repository policy requires it.
  • VCS Checkpoints: An atomic DogdouSpec document commit is locally durable but is not a Git checkpoint. Git-backed Mode B work should version managed .dogdouspec/ state at material boundaries, ignore only _tmp/, and never infer repository-write authority.
  • Authority Boundaries: Technical agents manage task lifecycles, execution records, and code changes autonomously. Product requirements, design decisions, and iteration completions require explicit human owner confirmation via iteration confirm.
Versions
1.0.4
1.0.3
Website
github.com
License
Last updated
10/14/2026
Download latest version
Loading...