# scale-engine **Repository Path**: chocolatebrianne/scale-engine ## Basic Information - **Project Name**: scale-engine - **Description**: AI 工程化脚手架引擎 — 让 AI Agent 在物理约束下工作,而不是靠提示词自律。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: https://scale-os.hongmaple.top - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 15 - **Created**: 2026-10-09 - **Last Updated**: 2026-10-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

version platforms agents tests npm

[![RepoStars](https://repostars.dev/api/embed?repo=hongmaple0820%2Fscale-engine&theme=copper)](https://repostars.dev/?repos=hongmaple0820%2Fscale-engine&theme=copper) # SCALE Engine v0.54.1 SCALE Engine turns AI-agent engineering discipline into executable commands, gates, and evidence files instead of relying on prompt discipline alone. It helps humans see what the agent explored, planned, verified, skipped, and why a task is or is not ready to ship. Source: https://github.com/hongmaple0820/scale-engine Mirror: https://gitee.com/hongmaple/scale-engine npm: https://www.npmjs.com/package/@hongmaple0820/scale-engine Language: [Chinese](README.md) | [English](README.en.md) Changelog: [CHANGELOG.md](CHANGELOG.md) ## What It Solves | Failure mode | SCALE mechanism | | --- | --- | | Agent says tests passed without running them | Verification profiles and evidence stores record actual commands and results | | Agent skips discovery, design, TDD, or review | `scale context`, `scale diagnose`, `scale tdd`, and `scale status` produce required next actions | | Agent accumulates uncommitted changes | Commit Discipline monitors git state with dual-threshold alerts and file grouping suggestions | | Agent stages unrelated files or edits wrong repo | Review-gated shipping, MOE workspace rules, and child repo blockers control boundaries | | Multi-session parallel work causes conflicts | Session Coordinator detects file overlaps, records conflicts, resolves dependency ordering | | Multi-repo Git workflow is chaotic | Cross-Repo Orchestrator coordinates branches, merge plans, and ship pipelines across repos | ## See It In 3 Minutes ```bash mkdir scale-demo && cd scale-demo npx -y @hongmaple0820/scale-engine@latest quickstart --dir . --profile standard npx -y @hongmaple0820/scale-engine@latest setup --dir . npx -y @hongmaple0820/scale-engine@latest preflight --preflight-profile quick --dir . ``` This generates governance files you can commit to a project: - `.scale/verification.json`: service matrix and verification profiles - `.scale/skills.json`: skill routing, source roots, and evidence requirements - `.scale/skills/`: committed source of truth for reusable workflow skills; legacy `skills/` is fallback-only - `.scale/tools.json`: CLI/MCP/browser/desktop orchestration policy - `docs/workflow/templates/`: Mini-PRD, plan, verification, review, and summary templates - `docs/standards/`: engineering, Git collaboration, and resource governance rules Continue with a full workflow loop: ```bash scale context grill --task-id TASK-001 --task "Harden OAuth callback" scale diagnose plan --task-id TASK-001 --symptom "callback returns 500 when state expires" scale tdd slice --task-id TASK-001 --behavior "reject expired OAuth state" --failing-test "expired state returns 401" ``` Read [npx and Interactive Install](docs/start/npx-interactive-install.md), [Quickstart](docs/start/quickstart.md), [22-Agent Installation Guide](docs/start/agent-installation-guide.md), and [Agent Governance Demo](docs/start/agent-governance-demo.md) for the complete walkthrough. For positioning against other workflows and agent frameworks, see [Workflow Capability and Competitive Comparison](docs/workflow/competitive-comparison.md). ## Installation For first-time evaluation, use `npx` without global install: ```bash npx -y @hongmaple0820/scale-engine@latest onboard --lang en npx -y @hongmaple0820/scale-engine@latest init --interactive --dir . ``` For frequent use, install the global CLI: ```bash npm install -g @hongmaple0820/scale-engine scale --version ``` Node.js 22 or newer is required. ## Who It Is For - Teams using Codex, Claude Code, Cursor, Gemini CLI, OpenCode, Aider, or similar agents on real projects. - Teams with multi-service, multi-repository, MOE workspace, or frontend/backend needs. - Teams that want agents to actively use skills, MCPs, CLIs, and browser automation with safety boundaries. - Project owners who feel AI code is fast but hard to review, verify, and maintain. ## Core Capabilities | Capability | Description | |------|------| | **Workflow Engine** | `define -> plan -> build -> verify -> review -> ship` phased delivery FSM | | **Gate System** | build, lint, test, coverage, security, TDD, review gates | | **AI OS Runtime** | `scale ai-os plan/run/status` — task planning, governed execution, dashboard | | **Commit Discipline** | Monitors git state, dual-threshold alerts, auto-groups uncommitted files | | **Session Coordinator** | Multi-session parallel coordination, file overlap detection, conflict recording | | **Cross-Repo Orchestrator** | Multi-repo Git workflow orchestration, coordinated branch/merge/ship | | **Task Dependency Graph** | DAG dependency declaration, topological sort, cycle detection | | **Ship Pipeline** | 8-step ship closure with dry-run, skip, version bump | | **Security Audit** | OWASP Top 10 + STRIDE security audit engine | | **Role Skills** | 6 role-based review perspectives (eng-manager, security-reviewer, qa-lead, etc.) | | **Memory Intelligence** | 6-signal quality scoring, cross-provider conflict detection, freshness decay | | **Governance ROI** | End-to-end governance ROI — token cost vs quality vs gate friction | ## AI OS Runtime AI OS Runtime is SCALE's core runtime planning layer. `scale ai-os plan` generates governance mode, Context Compiler budget, Memory Provider recall, Skill Routing execution plan, and Governance ROI in one command — so the agent knows what context to load, what capabilities to use, and what evidence to collect before starting. ```bash scale ai-os plan \ --task-id TASK-123 \ --task "Fix OAuth callback auth token handling and verify browser callback flow" \ --level L \ --files src/auth/oauth.ts,src/ui/callback.tsx \ --budget 8000 \ --json ``` See [AI OS Runtime docs](docs/AI_ENGINEERING_OS_POSITIONING.md) for the full command reference. ## Learning Path | Goal | Entry point | What you learn | | --- | --- | --- | | Try without global install | [npx and Interactive Install](docs/start/npx-interactive-install.md) | Run `onboard`, `init --interactive`, and `setup` with `npx` | | Get running | [Quickstart](docs/start/quickstart.md) | Install CLI, init governance files, run preflight | | Connect an agent | [22-Agent Installation Guide](docs/start/agent-installation-guide.md) | Initialize and verify Codex, Claude Code, Cursor, Cline, Windsurf, and other adapters | | See full loop | [Demo Walkthrough](docs/start/agent-governance-demo.md) | Context, diagnosis, TDD, artifact, and verification evidence | | Compare workflows | [Competitive Comparison](docs/workflow/competitive-comparison.md) | Position SCALE against LangGraph, AutoGen, CrewAI, gstack, Superpowers, ECC, and GitHub Agentic Workflows | | Adopt in existing project | [Workflow Upgrade Guide](docs/start/workflow-upgrade.md) | `init`, `upgrade check/plan/apply`, local `make` wrappers | | Choose governance pack | [Governance Pack docs](docs/start/README.md) | Which pack fits your project shape | | Maintain or extend SCALE | [docs/README.md](docs/README.md) | Documentation map, internal modules, long-term maintenance | | Develop this repo | [docs/guides/GETTING_STARTED.md](docs/guides/GETTING_STARTED.md) | `scale-engine` repo's own engineering workflow | ## Workflow Upgrade ```bash scale upgrade check --dir . --lang en scale upgrade plan --dir . --html --lang en scale upgrade apply --dir . --confirm --lang en ``` SCALE splits upgrades into three layers: the CLI itself, generated governance pack files, and third-party skills/MCP/CLI capabilities. It only checks and generates plans by default — it never auto-overwrites user-edited files. See [Workflow Upgrade Guide](docs/start/workflow-upgrade.md). ## Developing This Repo ```bash make preflight make gate-workflow make gate-quality make verify PROFILE=default ``` Entry docs: - [docs/guides/GETTING_STARTED.md](docs/guides/GETTING_STARTED.md) — 15-minute onboarding - [docs/guides/DEVELOPMENT_WORKFLOW.md](docs/guides/DEVELOPMENT_WORKFLOW.md) — daily dev loop - [docs/workflow/README.md](docs/workflow/README.md) — gates, branch policy, upgrade entry ## Community | Platform | Link | Purpose | | --- | --- | --- | | GitHub | https://github.com/hongmaple0820/scale-engine | Source, issues, and PRs | | Gitee | https://gitee.com/hongmaple/scale-engine | China mirror and feedback | | npm | https://www.npmjs.com/package/@hongmaple0820/scale-engine | CLI package | | QQ Group | 628043364 | Community chat and support | | Email | 2496155694@qq.com | Cooperation, feedback, and suggestions |

SCALE Engine WeChat public account    Personal WeChat    Feishu group

## Sponsorship If SCALE Engine saves engineering governance time for your team, or helps move AI-agent work into a verifiable, reviewable, and releasable loop, voluntary sponsorship is welcome. Sponsorship supports maintenance, examples, documentation, test coverage, and community support.

Sponsor with WeChat Pay    Sponsor with Alipay

## License [MIT](LICENSE)