moai-harness-learner

Coordinates Tier 4 harness learning proposals and orchestrates Apply/Rollback flows via CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing the lifecycle of harness learning proposals—inspecting tier distribution, fetching pending auto-update payloads, applying approved changes, and rolling back snapshots—requires a consistent bridge between the moai harness CLI and the orchestrator's user-approval flow, which this Skill provides. ## Core Features & Use Cases - Proposal Payload Production: Runs moai harness apply to fetch Tier 4 auto-update proposals as structured JSON payloads (proposal_id, target_path, field_key, new_value, confidence) for the orchestrator to surface via AskUserQuestion. - Apply/Rollback Orchestration: On approval, writes a decision file and executes the change through the 5-Layer Safety Pipeline; on rejection, removes the proposal; supports snapshot-based rollback via moai harness rollback <date>. - Learning Lifecycle Control: Checks tier distribution and rate-limit status with moai harness status, and disables learning with moai harness disable while preserving YAML comments. - Use Case: When the harness observer accumulates enough pattern observations to propose a skill description update, use this Skill to fetch the proposal, hand it to the orchestrator for user approval, and apply or discard it safely. ## Quick Start Ask the AI 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 proposal payload, have the orchestrator surface it via AskUserQuestion, then 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 snapshot taken before the update was applied.

What is the 5-Layer Safety Pipeline in harness learning?▼

It gates every Tier 4 auto-update through L1 Frozen Guard, L2 Canary Check, L3 Contradiction Detector, L4 Rate Limiter (max 3 per week, 24h cooldown), and L5 Human Oversight via orchestrator approval. Violations at any layer block the change.

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/`. Frozen paths like `.claude/agents/moai/**`, `.claude/skills/moai-*/**`, and `.claude/rules/moai/**` are never auto-modified.

How do I disable harness learning?▼

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