truth-projection

Verifies hub projection state against disk truth using factory-now and run-inbox data.

Updated Jun 20, 2026
One-click install
npx skills add https://github.com/Noetfield-Systems/SourceA --skill truth-projection-noetfield-systems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: truth-projection
Source: https://github.com/Noetfield-Systems/SourceA/tree/main/.cursor/skills/truth-projection
Command: npx skills add https://github.com/Noetfield-Systems/SourceA --skill truth-projection-noetfield-systems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents often quote stale or hallucinated progress numbers from chat memory instead of the actual disk state, causing the hub projection to drift from the real factory state. This Skill enforces reading disk truth before quoting any progress or hub state. ## Core Features & Use Cases - Agent truth bundle: Runs agent_truth_bundle_v1.py and factory_control_v1.py now at session start to load authoritative state. - Two-plane model: Separates the control plane (factory-now-v1.json, run-inbox-disk-truth-v1.json) from the projection plane (command-data.json, rebuilt via hub_projection_sync_v1). - Dual-pick law validation: Detects projection bugs by checking that live_pick equals queue_sa. - Use Case: Before replying with a status update, an agent runs the truth bundle, quotes the factory-now line, and flags any mismatch between goal-progress and run-inbox truth as a projection bug. ## Quick Start Ask the agent to run the truth bundle and quote the current factory-now line before reporting any hub progress.

Frequently Asked Questions about truth-projection

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

FAQPage Schema
How do I check factory progress without trusting chat memory?

Run python3 scripts/agent_truth_bundle_v1.py --json followed by python3 scripts/factory_control_v1.py now at session start, or call GET http://127.0.0.1:13020/api/agent-truth-bundle-v1. Quote the factory-now line directly in status replies.

What is the difference between control plane and projection plane state?

The control plane is the source of truth stored in factory-now-v1.json and run-inbox-disk-truth-v1.json. The projection plane is command-data.json, a derived view rebuilt via hub_projection_sync_v1 that can drift from disk truth.

How do I detect a stale hub projection?

Apply the dual-pick law: live_pick from goal-progress must equal queue_sa from run-inbox truth. A mismatch between these two values indicates a projection bug requiring a rebuild via hub_projection_sync_v1.

Why does the agent mention AUTO-RUN when it should not?

Cursor AUTO-RUN does not exist, so mentioning it means the agent is operating on stale memory. The fix is to read disk state in the same turn using the truth bundle scripts before making any claims.

Can I query the agent truth bundle over HTTP?

Yes, the truth bundle is exposed at GET http://127.0.0.1:13020/api/agent-truth-bundle-v1 as an alternative to running the local Python scripts directly.