# Control Metalayer Loop

> Create and maintain a control-system metalayer for autonomous code-agent development in any repository. Use when you need explicit control primitives (setpoints, sensors, controller policy, actuators, feedback loop, stability and entropy controls), repo command/rule governance, and a scalable folder topology that lets agents operate safely and keep improving over time.

- **Type:** Skill
- **Install:** `agentstack add skill-broomva-control-metalayer-control-metalayer-loop`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [broomva](https://agentstack.voostack.com/s/broomva)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [broomva](https://github.com/broomva)
- **Source:** https://github.com/broomva/control-metalayer/tree/main/.skills/control-metalayer-loop

## Install

```sh
agentstack add skill-broomva-control-metalayer-control-metalayer-loop
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Control Metalayer Loop

Use this skill to initialize or upgrade a repository into a control-loop driven agentic development system.

## What To Load

- `references/control-primitives.md` for the control model and minimal control law.
- `references/rules-and-commands.md` for policy/rules and command governance.
- `references/topology-growth.md` for repository topology and scale path.
- `references/wizard-cli.md` for command usage.

## Primary Entry Point

Use the Typer wizard:

```bash
python3 scripts/control_wizard.py init  --profile governed
```

Profiles:

- `baseline`: minimal harness and command surface.
- `governed`: baseline + policy/commands/topology + control loop + metrics + git hooks.
- `autonomous`: governed + recovery/nightly controls + web and CLI E2E primitives.

## Workflow

1. Baseline current repo workflows and constraints.
2. Initialize baseline metalayer artifacts.
3. Add control primitives and governance rules.
4. Audit and close gaps.
5. Iterate based on run outcomes and metric drift.

## Step 1: Baseline

- Identify canonical test/lint/typecheck/build commands.
- Identify high-risk actions requiring policy gates.
- Identify required observability IDs for agent runs.

## Step 2: Initialize Metalayer

Run:

```bash
python3 scripts/control_wizard.py init  --profile baseline
```

This creates stable operational interfaces:

- `AGENTS.md`, `PLANS.md`, `METALAYER.md`
- `Makefile.control` and `scripts/control/*`
- `docs/control/ARCHITECTURE.md` and `docs/control/OBSERVABILITY.md`
- CI workflow for control checks

## Step 3: Add Control Primitives

Run:

```bash
python3 scripts/control_wizard.py init  --profile governed
```

This adds the core control plane:

- `.control/policy.yaml`
- `.control/commands.yaml`
- `.control/topology.yaml`
- `docs/control/CONTROL_LOOP.md`
- `evals/control-metrics.yaml`

For a fully self-sustaining loop:

```bash
python3 scripts/control_wizard.py init  --profile autonomous
```

Adds:

- `scripts/control/install_hooks.sh` + `.githooks/*`
- `scripts/control/recover.sh`
- `scripts/control/web_e2e.sh`
- `scripts/control/cli_e2e.sh`
- `.github/workflows/web-e2e.yml`
- `.github/workflows/cli-e2e.yml`
- `tests/e2e/web/*` + `playwright.config.ts`
- `tests/e2e/cli/smoke.sh`
- `.control/state.json`
- `.github/workflows/control-nightly.yml`

## Step 4: Validate

Run:

```bash
python3 scripts/control_wizard.py audit 
python3 scripts/control_wizard.py audit  --strict
```

Treat audit failures as blocking until corrected.

## Step 5: Operate And Grow

- Keep command names stable (`smoke`, `check`, `test`, `recover`).
- Keep E2E command names stable (`web-e2e`, `cli-e2e`).
- Keep policy and command catalog synchronized with actual behavior.
- Track control metrics and adjust setpoints deliberately.
- Prune stale rules/scripts/docs to prevent entropy growth.

## Adaptation Rules

- Do not overwrite existing project conventions without explicit reason.
- Prefer wrappers and policy files over ad-hoc command execution.
- Make every major behavior observable and auditable.
- Keep human escalation rules explicit and easy to trigger.

## Broomva Stack Position

**Layer 1 (Foundation)** — part of the [24-skill Broomva Stack](https://github.com/broomva/bstack).

## Related Skills

- `agent-consciousness` (L2) — Architectural synthesis of how the control metalayer, knowledge graph, and conversation logs form a persistent consciousness for agents.
- `knowledge-graph-memory` (L2) — Bridge script that transforms Claude Code conversation logs into Obsidian-compatible session documents, creating episodic memory for the knowledge graph.
- `drift-check` (L7) — Reads control-metalayer setpoints to detect priority misalignment against actual effort.
- `harness-engineering-playbook` (L1) — Agent-first workflow that builds on control primitives for deterministic harness commands.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [broomva](https://github.com/broomva)
- **Source:** [broomva/control-metalayer](https://github.com/broomva/control-metalayer)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-broomva-control-metalayer-control-metalayer-loop
- Seller: https://agentstack.voostack.com/s/broomva
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.