{"id":48499633,"url":"https://github.com/haaaiawd/anws","last_synced_at":"2026-05-06T07:05:08.713Z","repository":{"id":333469804,"uuid":"1137360227","full_name":"Haaaiawd/ANWS","owner":"Haaaiawd","description":"🚀 A spec-driven workflow framework for AI-assisted development. Empowers prompt engineers to build production-ready software through structured PRD → Architecture → Task decomposition. Designed for Antigravity to enforce design-first principles and prevent architectural drift in vibe coding.🗺️Antigravity-Workflow-System","archived":false,"fork":false,"pushed_at":"2026-04-07T12:24:25.000Z","size":2266,"stargazers_count":136,"open_issues_count":3,"forks_count":19,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-04-07T14:56:02.072Z","etag":null,"topics":["agentic-ai","antigravity","devops-for-ai","prompt-engineering","skills-framework","system-architecture","vibe-coding","workflow-orchestration"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Haaaiawd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-19T09:14:51.000Z","updated_at":"2026-04-07T12:24:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"b5a9e2dc-d920-4f3e-b407-faee8b44cce6","html_url":"https://github.com/Haaaiawd/ANWS","commit_stats":null,"previous_names":["haaaiawd/antigravity-workflow-system","haaaiawd/anws"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/Haaaiawd/ANWS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haaaiawd%2FANWS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haaaiawd%2FANWS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haaaiawd%2FANWS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haaaiawd%2FANWS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Haaaiawd","download_url":"https://codeload.github.com/Haaaiawd/ANWS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haaaiawd%2FANWS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32288653,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T06:26:00.361Z","status":"ssl_error","status_checked_at":"2026-04-26T06:25:58.791Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","antigravity","devops-for-ai","prompt-engineering","skills-framework","system-architecture","vibe-coding","workflow-orchestration"],"created_at":"2026-04-07T14:02:45.799Z","updated_at":"2026-05-03T10:01:27.272Z","avatar_url":"https://github.com/Haaaiawd.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"assets/logo-cli.png\" width=\"260\" alt=\"Anws\"\u003e\n\n[![License: MIT](https://opensource.org/licenses/MIT)](https://opensource.org/licenses/MIT)\n[![Version](https://img.shields.io/badge/version-v2.2.2-7FB5B6)](https://github.com/Haaaiawd/ANWS/releases)\n[![Targets](https://img.shields.io/badge/Targets-Windsurf%20%7C%20Claude%20Code%20%7C%20Copilot%20%7C%20Cursor%20%7C%20Codex%20Preview%20%7C%20OpenCode%20%7C%20Trae%20%7C%20Qoder%20%7C%20Kilo%20Code-blueviolet)](https://github.com/Haaaiawd/ANWS)\n\n[English](./README.md) | [中文](./README_CN.md)\n\n\u003c/div\u003e\n\n---\n\n# Anws\n\n**Anws** is a spec-driven workflow framework for AI-assisted development across modern AI IDEs and coding tools.\n\nIt helps teams build production-ready software through a disciplined path:\n\n`PRD -\u003e Architecture -\u003e ADR -\u003e Tasks -\u003e Review -\u003e Code -\u003e Upgrade`\n\nAnws enforces design-first principles, preserves context in files, and prevents architectural drift across multi-tool AI coding workflows.\n\n\u003e **TL;DR**: a design-first workflow framework for AI coding tools that turns vibe coding into production-oriented engineering.\n\n## ANWS\n\n- **Axiom** — principle before implementation\n- **Nexus** — connection before fragmentation\n- **Weave** — coherence before accumulation\n- **Sovereignty** — human judgment before automation\n\n---\n\n## Why Anws Exists\n\nModern AI coding sessions fail in predictable ways:\n\n- **Architecture drift**\n  - different sessions generate incompatible structures\n- **Context amnesia**\n  - a fresh chat loses system decisions, trade-offs, and task state\n- **Planning collapse**\n  - code gets written before requirements and interfaces are stabilized\n- **Unsafe upgrades**\n  - workflow files change over time, but existing projects cannot be updated cleanly\n\nAnws addresses those problems with:\n\n- **Versioned architecture docs** under `.anws/v{N}/`\n- **A root anchor file** via `AGENTS.md`\n- **Workflow-first execution** instead of prompt-only improvisation\n- **Controlled update semantics** for `AGENTS.md`, installed targets, and upgrade history\n\n---\n\n## What's New in v2.2.2\n\n**v2.2.2** centers the **`/forge`** chain: **`/forge` AUTO** keeps checkpoint ceremony with **`AUTO`** signatures; **`code-reviewer`** follows **wave cadence** (typically **once per wave** at the wave’s last task, with a **~2–3 wave** catch-up if long skipped—not after every task by default); **`e2e-testing-guide`** is **guide first**, then live browser steps when tooling exists—otherwise **guide-only**, never claim “tested” without evidence. **`/change`** handles doc/task backflow only—it **does not run `code-reviewer`** (static fidelity stays in **`/forge` §3.4.5** and **`/challenge`**).\n\n**v2.2.0** shipped closed-loop **challenge**, explicit contract closure, **`code-reviewer`** as static evidence, forge challenge-report gates, and **`e2e-testing-guide`**. Full history: **[RELEASE_NOTES.md](../RELEASE_NOTES.md)** · [GitHub Releases](https://github.com/Haaaiawd/ANWS/releases).\n\n**v2.0.0** was the protocol-level major (unified **`.anws/`**, controlled **`AGENTS.md`**, multi-target projection). See **[RELEASE_NOTES.md](../RELEASE_NOTES.md)** for the complete major changelog.\n\n---\n\n## Quick Start\n\n### Install via npm\n\n```bash\nnpm install -g @haaaiawd/anws\ncd your-project\nanws init\n```\n\n- **Requirement**\n  - Node.js `\u003e= 18`\n- **Install behavior**\n  - `anws init` installs one or more target projections into their native folders\n  - example: `anws init --target windsurf,opencode`\n\n### Update an Existing Project\n\n```bash\ncd your-project\nanws update\n```\n\n- **Update flags**\n  - `anws update --check` and `anws update --target` are removed; run `anws update` once to refresh all matched targets\n- **State source**\n  - `anws update` reads `.anws/install-lock.json`\n  - if the lock is missing or invalid, it falls back to directory scan\n  - if lock drift is detected, directory scan becomes the effective source for the current update\n  - a real `anws update` can rebuild `.anws/install-lock.json` from detected targets when fallback is active\n- **`AGENTS.md` behavior**\n  - marker-based file -\u003e update stable sections, preserve `AUTO` block\n  - recognized legacy file -\u003e migrate into new marker-based structure\n  - unrecognized legacy file -\u003e warn and preserve unchanged\n- **Legacy migration**\n  - if a project still has `.agent/`, the CLI can guide migration to `.agents/`\n  - after successful migration, interactive mode can also ask whether to delete the old `.agent/`\n- **Upgrade record**\n  - every successful update refreshes `.anws/changelog/`\n  - target state is written back to `.anws/install-lock.json`\n\n---\n\n## Feature demos\n\nWhat using Anws looks like in practice: architecture-first **`/genesis`**, **human-in-the-loop** requirement alignment, and **skill** orchestration.\n\n**Deep Thinking \u0026 Architecture Design**  \n\u003cimg src=\"assets/genesis工作流演示.jpg\" width=\"800\" alt=\"Genesis Workflow\"\u003e\n\n**Interactive Requirement Alignment**  \n\u003cimg src=\"assets/与人类交互确认细节.jpg\" width=\"800\" alt=\"Human Interaction\"\u003e\n\n**Autonomous Skill Invocation**  \n\u003cimg src=\"assets/自主调用skills.jpg\" width=\"800\" alt=\"Skills Execution\"\u003e\n\n---\n\n## Philosophy\n\n**1. Docs first—specs keep you in command**  \nPRD, architecture, tasks, and design land in the repo before code does—so the project doesn’t drift in aimless “vibe runs.” Scope and progress live in `.anws/`, `05_TASKS.md`, and **`AGENTS.md`**: you stay **in control of the system**, not whichever chat window is open.\n\n**2. Full autonomy inside the rails**  \n**`/forge` AUTO** is delegation with checkpoints: keep moving inside agreed contracts. **Code review**, **e2e-testing-guide**, and the rest of the template gates keep runs **auditable** and **bounded**. When a wave is executing, it’s reasonable to **walk away—coffee, a walk**—because confidence comes from the spec and gates, not from staring at the model.\n\n**Iteration is the product**  \n**`/challenge`** isn’t a one-time rubber stamp; it’s repeated adversarial passes. **Good products and clear ideas are sharpened over cycles**—same as real shipping: each round pulls design, tasks, and implementation back into alignment.\n\n---\n\n## Recommended Workflow\n\nUse Anws as a lifecycle, not just a folder pack.\n\n\n| Command           | Purpose                                                                     | Input                 | Output                   |\n| ----------------- | --------------------------------------------------------------------------- | --------------------- | ------------------------ |\n| **`/quickstart`** | Route the user through the correct workflow path                            | Auto-detected state   | Full orchestration       |\n| `/genesis`        | Start from zero with PRD and architecture                                   | Vague idea            | PRD, architecture, ADRs  |\n| `/probe`          | Analyze a legacy codebase before change                                     | Existing code         | Risk report              |\n| `/design-system`  | Design one system in depth                                                  | Architecture overview | System design doc        |\n| `/challenge`      | Review design, tasks, and implementation fidelity with adversarial pressure | Docs / tasks / code   | Challenge report         |\n| `/blueprint`      | Break architecture into executable work                                     | PRD + architecture    | `05_TASKS.md`            |\n| `/forge`          | Turn approved tasks into code with challenge-report and contract gates      | Tasks + review state  | Working implementation   |\n| `/change`         | In-version task/contract tweaks (controlled expansion: few new tasks)       | Small scoped change   | Updated task/design docs |\n| `/explore`        | Research ambiguous or strategic topics                                      | Topic                 | Exploration report       |\n| `/craft`          | Create workflows, skills, and prompts                                       | Creation request      | Reusable assets          |\n| `/upgrade`        | Route post-update upgrade work                                              | Update changelog      | Change or genesis path   |\n\n\n---\n\n## Contributing\n\nContributions are welcome. Before opening a PR, make sure changes align with the spec-driven workflow and the target projection model.\n\n---\n\n## License\n\n[MIT](LICENSE) © 2026\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made for architects who code, and AIs who think.**\n\n*Good architecture isn't written. It's designed.*\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaaaiawd%2Fanws","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhaaaiawd%2Fanws","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaaaiawd%2Fanws/lists"}