moai-harness-learner

Coordinates Tier 4 auto-update proposal payloads and Apply/Rollback flows for harness learning.

Updated Aug 29, 2026
One-click install
npx skills add https://github.com/Seung-zedd/secure-file-upload --skill moai-harness-learner-seung-zedd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-harness-learner
Source: https://github.com/Seung-zedd/secure-file-upload/tree/main/.claude/skills/moai-harness-learner
Command: npx skills add https://github.com/Seung-zedd/secure-file-upload --skill moai-harness-learner-seung-zedd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing a self-improving harness learning subsystem requires a controlled bridge between CLI commands and user approval decisions. This Skill produces structured Tier 4 auto-update proposal payloads that the orchestrator surfaces via AskUserQuestion, ensuring no learning-driven change is applied without explicit human approval. ## Core Features & Use Cases - Proposal Payload Generation: Runs moai harness apply to fetch pending Tier 4 proposals and emits a structured JSON payload (proposal_id, target_path, field_key, new_value, confidence, recommended_action) for orchestrator consumption. - Apply/Rollback Orchestration: Coordinates approval writes to .moai/harness/proposals/, executes approved changes via the 5-Layer Safety Pipeline, and restores snapshots with moai harness rollback. - Lifecycle Management: Checks tier distribution and rate limits with moai harness status, and disables learning via moai harness disable while preserving YAML comments. - Use Case: When the harness observer accumulates enough pattern observations to propose updating a user-area skill's description or triggers, use this Skill to surface the proposal for approve/reject/inspect/defer and execute the chosen action safely. ## 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 approve a harness learning auto-update proposal?▼

Run `moai harness apply` to fetch the pending proposal payload, then the orchestrator surfaces it via AskUserQuestion with approve, reject, inspect, or defer options. On approval, write `approved: true` to the proposal decision file and run `moai harness apply --execute --id <proposal-id>`.

How do I roll back a harness learning change?▼

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

What files can harness auto-updates modify?▼

Only user-area skills under `.claude/skills/hns-*/` (plus legacy harness generations) and agents under `.claude/agents/harness/` are valid targets. Frozen paths like `.claude/agents/moai/**`, `.claude/skills/moai-*/**`, and `.claude/rules/moai/**` are never auto-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 Contradiction Detector blocks trigger conflicts, L4 Rate Limiter caps updates at 3 per week with 24h 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.