moai-harness-learner

Coordinates harness learning proposals and orchestrates apply and rollback flows via CLI.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/taewook486/Masters_degree --skill moai-harness-learner-taewook486
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-harness-learner
Source: https://github.com/taewook486/Masters_degree/tree/main/.claude/skills/moai-harness-learner
Command: npx skills add https://github.com/taewook486/Masters_degree --skill moai-harness-learner-taewook486

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing a self-improving harness learning subsystem requires careful coordination between CLI commands, proposal payloads, and user approval flows. This Skill bridges the moai harness CLI and the orchestrator's AskUserQuestion interface so Tier 4 auto-update proposals are surfaced, approved, applied, or rolled back safely. ## Core Features & Use Cases - Proposal Payload Production: Runs moai harness apply to fetch pending Tier 4 auto-update proposals and emits a structured JSON payload (proposal_id, target_path, field_key, new_value, confidence, recommended_action) for orchestrator consumption. - Apply/Rollback Orchestration: Writes approval decisions to .moai/harness/proposals/, executes approved changes via moai harness apply --execute, and restores snapshots with moai harness rollback <date>. - Safety-Gated Lifecycle: Every auto-update passes a 5-Layer Safety Pipeline (Frozen Guard, Canary Check, Contradiction Detector, Rate Limiter, Human Oversight), with frozen paths like .claude/skills/moai-*/** never modified. - Use Case: After a week of harness observations, run moai harness status to see three pending proposals, fetch the next one, let the orchestrator ask the user to approve or reject it, and apply the approved change to a user-area hns-* skill description. ## Quick Start Ask the assistant to check harness learning status and surface any pending auto-update proposals for approval.

Frequently Asked Questions about moai-harness-learner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I apply a pending harness learning proposal?▼

Run `moai harness apply` to fetch the next pending proposal as a JSON payload, then have the orchestrator surface it via AskUserQuestion. On approval, write `approved: true` to the proposal's decision file and run `moai harness apply --execute --id <proposal-id>`.

How do I roll back a harness auto-update?▼

List available snapshots with `ls .moai/harness/learning-history/snapshots/`, then run `moai harness rollback <timestamp> --project-root <project_root>` to restore the skill or agent file to its previous state.

Which files can harness auto-updates modify?▼

Only user-area skills under `.claude/skills/hns-*/` (plus legacy `harness-*` and `my-harness-*` generations) and agents under `.claude/agents/harness/` are valid targets. Frozen paths like `.claude/skills/moai-*/**` and `.claude/rules/moai/**` are never modified.

What safety checks protect harness auto-updates?▼

A 5-Layer Safety Pipeline gates every Tier 4 update: L1 Frozen Guard blocks protected paths, L2 Canary Check blocks effectiveness drops over 0.10, L3 detects trigger contradictions, L4 enforces a rate limit of 3 updates per week with 24-hour cooldown, and L5 requires human approval.

How do I disable harness learning entirely?▼

Run `moai harness disable --project-root <project_root>`. This sets `learning.enabled: false` in `.moai/config/sections/harness.yaml` while preserving comments and key ordering through YAML round-trip.