Mock2 Standards …
For VS Code · Copilot · Claude

Development standards, installed in one command.

Consistent AI-assisted workflows for VS Code, Claude and GitHub Copilot — on this machine, and in the repositories you reach over SSH.

PS>irm https://mock2.fractionate.ai/install.ps1 | iex

Windows PowerShell 5.1 or PowerShell 7. No administrator access needed.

No administrator access Never overwrites edited files Safe to run again
Offline transfer

Download once. Carry it to your server.

A complete, versioned source ZIP for a machine behind a firewall or without a connection. Includes the repository template, tools and step-by-step transfer instructions.

Download offline ZIP Read transfer instructions

Loading package details…

Extract into a separate folder, then update your project with the included local-folder upgrader. The guide covers checksums, file locations, VS Code and Git rebasing.

Relay · Work, in view

See the work as it happens.

Running timers, blue imported Git history, green recorded activity, and the steps behind every task. Use the top tabs and work list to follow parallel work, replay a repair, trace ideas, or inspect check execution and reuse. Add Relay inside your existing app using its own access rules, storage and design.

Interactive demoSimulated activity · changes reset on reload
What it installs

Everything an AI-assisted repo needs, in your home folder.

The command writes the standards into ~/.claude, ~/.copilot and ~/.mock2. Every folder you open in VS Code gets them; nothing outside your home folder is touched.

Installs the standards

The constitution, scoped rules, the stage prompts, the three agents, the hooks and the repository templates.

Protects your changes

A file you edited is never silently replaced. The new version lands beside it as .mock2-new and is reported.

Stays current

The SessionStart hook checks the published version and applies safe updates; every file is hash-verified before anything is written.

Supports remote repos

Puts the agents and prompts into a repository over the SSH connection you already have. Nothing is installed on that host.

How it works

From one command to the first feature.

Run one command

Paste it into PowerShell and press Enter.

Standards installed

Verified files land in your home folder; nothing else is touched.

Restart VS Code

The customizations and the hooks load on the next start.

Open or create a repo

Type /mock2-init in any repository, local or remote.

Use the Mock2 commands

Concept → define → build → check. Nothing blocks building.

After install

Five steps and you are working.

01

Restart VS Code

Customizations and hooks are read at start-up.

02

Verify the Mock2 customizations

Command Palette → Chat: Open Customizations. The Mock2 entries appear under Instructions, Prompts, Agents and Hooks.

03

Open a chat

The first thing the agent knows is “Mock2 standards loaded (v…)”. That line comes from the SessionStart hook.

04

Initialize a repository

New repo: create it from the project template, clone, type /mock2-init. Existing repo: just /mock2-init.

05

Start the feature workflow

Begin at whichever stage fits. No stage refuses to proceed; run an impact-scoped production checklist when requested or when a change is ready, using valid recorded evidence.

Details

The technical detail, when you want it.

Installation details
  • Every file in the release is downloaded and hash-verified into a staging folder first. The version marker is written last, after the copy succeeded, so an interrupted run never describes itself as current.
  • Writes into ~/.claude/ (constitution + rules), ~/.copilot/ (prompts, agents, hooks) and ~/.mock2/ (hook scripts, repo templates, version marker). Files retired by a newer version are removed only when they are demonstrably the installer's own, unmodified.
  • ~/.claude/CLAUDE.md is never owned: it receives one marked block that imports the constitution; everything else in it is yours.
  • A managed file whose contents no longer match what the installer last wrote is kept, reported, and the new version put beside it as <name>.mock2-new. To take the release over your copies (kept under ~/.mock2/backup):
& ([scriptblock]::Create((irm https://mock2.fractionate.ai/install.ps1))) -Force
  • Installs the GitHub Copilot and Copilot Chat extensions when the code command is on PATH.
  • It never closes your window: piped through iex it runs inside your session, prints any failure, and returns you to the prompt. Diagnose an install with node ~/.mock2/bin/doctor.mjs.
Remote repository setup

A repository you work on over SSH sits on a machine that has never run the installer, and VS Code Remote-SSH reads customizations from that host's home folder. So the agents and prompts go into the repository itself, where VS Code reads them as workspace customizations.

  • The installer ends by offering the remote step. Every repository set up from this machine is catalogued in ~/.mock2/remotes.json, so it offers Update for those (one, or all) before the choices for a new host.
  • New host: pick one from your .ssh/config, pick a folder (git repos are marked), see what would be added, updated or kept, confirm.
  • Writes .github/agents/, .github/prompts/, .mock2/, state/, CLAUDE.md, AGENTS.md and .github/copilot-instructions.md. Files are carried over your existing SSH session; the remote host needs bash, tar and a sha256 tool, no network, nothing installed.
  • Version-aware: a pristine file from an earlier release is updated, an edited one is kept with the new version beside it. The apply is journalled and recovers from an interrupted run.
  • Commit what it adds. Every later clone then carries the agents and no one has to run anything.
User level for the machine, repo level for the clone

VS Code reads ~/.copilot/prompts, ~/.copilot/agents and ~/.copilot/hooks for every workspace, and Claude Code reads ~/.claude/CLAUDE.md and ~/.claude/rules/ — so on a machine you have installed, the shared standards live once. A repository also carries its own copies of the agents and stage prompts under .github/agents/ and .github/prompts/; that is what makes a clone work on a host where nothing has been installed. The two copies are the same file, generated from core/copilot/ when the standards publish, so an agent is only ever edited in one place. On top of that a repo carries what is specific to it (.github/copilot-instructions.md, state/).

No gates; a checklist instead

Nothing in the standards may refuse, restrict or delay building or testing. Production-policy questions that come up during work are classified (implementation requirement, configurable capability, checklist item, recommendation) and only an explicit requirement changes what gets built. When requested or when a change is ready, /mock2-check runs the applicable production checklist in an independent reviewer context and writes the change record. Valid recorded evidence is reused; missing or stale evidence is checked. Developer acceptance is recorded separately, and promotion is a person's decision informed by the evidence.

Hooks and updates

SessionStart fetches manifest.json, re-runs the installer if the version changed, and injects the loaded version into the chat context. Stop appends a line to ~/.mock2/ledger.jsonl (session, folder, latest change record) and, when MOCK2_API is set, posts it to the standards server. The hooks are user level, so a repository seeded onto a remote host does not self-update — bring it current by running the command again and choosing Update, or /mock2-init on a machine that has the installer.

This site is a repository

Everything here is mock2/mock2-core, the source repository. To change a standard, edit the file under core/, bump version in manifest.json, and open a pull request. When it merges to main, a webhook updates this site within seconds and every developer picks the change up at their next chat.

Phase 2 (planned): an MCP endpoint at /mcp with get_rules, search_learnings and propose_rule, plus a session feed and a proposals inbox on this site. The reserved entry is already in mcp-config.json.

Files

Everything the installer writes.

Exactly as it will land on your machine. Click a file to read it.

Select a file
Loading manifest…

Set up this machine now.

One command. Nothing outside your home folder. Safe to run again.

Install Browse the source
Copied!