{"slug": "luna-forge", "title": "Luna Forge", "summary": "Luna Forge, a compact Codex Skill and custom worker for GPT-5.6 Luna, claims to deliver more independently accepted bounded engineering work per unit of cost by rejecting 95.71% of a 7,009-line source corpus, retaining only 301 portable or distilled lines (4.29%) and reducing context to ~2,964 tokens, a 96.89–96.90% reduction. The project, by RealAhmedOsama, labels its quality uplift of 5–15% relative score improvement as 'Projected' with 0.65 judgment confidence, pending a repository benchmark, and does not claim Luna is universally more capable than Sol or Claude Fable.", "body_md": "**Evidence-driven execution for GPT-5.6 Luna.**\n\nA compact Codex Skill and custom worker that convert clear engineering requests into bounded tasks, minimal patches, deterministic proof, and auditable delivery.\n\n[ Results](#results-at-a-glance) ·\n\n[·](#the-three-source-study)\n\n**Research**[·](#how-luna-forge-works)\n\n**Architecture**[·](#cost-model)\n\n**Economics**[·](#benchmark-protocol)\n\n**Benchmark**[·](#installation)\n\n**Install**\n\n**Publish** Important\n\nLuna Forge does **not** claim that prompting can make Luna universally more capable than Sol, Claude Fable, or any frontier model. It targets a narrower, testable objective: **more independently accepted bounded engineering work per unit of cost**. Cost figures are derived from reviewed rate cards. The quality uplift is **Projected, not measured** until the included repository benchmark is completed.\n\nGPT-5.6 Luna is attractive for high-volume, cost-sensitive engineering work, but the right strategy is not to paste a frontier product's entire system prompt into a smaller model. That would front-load tens of thousands of tokens of foreign tools, schemas, UI protocols, runtime metadata, duplicated instructions, and product-specific policy before Luna reaches the repository evidence that actually matters.\n\nLuna Forge began with a harder question:\n\nWhat remains useful after every non-portable line is removed, every retained idea is traced to an implementation, and every performance claim is forced to show its evidence class?\n\nThe answer was surprisingly small:\n\n```\n~95,248–95,459 estimated source tokens\n                ↓\n7,009 physical source lines classified\n                ↓\n301 portable or distillable lines (4.29%)\n                ↓\n~2,964-token activated Skill + agent core\n                ↓\n8 references loaded only when the task needs them\n```\n\nThe project rejected **95.71%** of the reviewed source corpus. That rejection is the core design achievement: the workflow keeps transferable execution mechanisms and discards host-specific mass.\n\n| Result | Value | Evidence class | Proof |\n|---|---|---|---|\n| Source snapshots reviewed | 3 |\nMeasured |\n`docs/audit-summary.json` |\n\n**7,009**`docs/line-by-line-audit.csv`\n\n**100%****301****4.29%**`301 / 7,009`\n\n**6,708****95.71%**`6,708 / 7,009`\n\n**6,398**`docs/source-line-fingerprints-first-two.csv`\n\n**Git blob SHA-1**`d5434648e7d859969403cbb3d8e4209390ce001b`\n\n**95,248–95,459 tokens**`docs/metrics.json`\n\n**~2,964 tokens****96.89–96.90%****~9,141 tokens****90.40–90.42%****21**`evals/cases.yaml`\n\n**18**`tests/`\n\n**14****96%****96%****5–15% relative**`docs/IMPACT_MODEL.md`\n\n**0.65****Not claimed**\n\n```\npie showData\n    title Disposition of 7,009 reviewed lines\n    \"Portable or distilled\" : 301\n    \"Excluded, deferred, or structural\" : 6708\n```\n\nEvery material claim is labeled as one of four classes.\n\n| Label | Meaning | Examples |\n|---|---|---|\nMeasured |\nCounted, hashed, executed, or observed directly in this package | Audit rows, source anchors, tests, manifest, archive hash |\nDerived |\nReproducible arithmetic from measured inputs or a cited rate card | 4.29% portability, 96.9% context reduction, 96% equal-token savings on both reviewed rate cards |\nExternal |\nReported by another source under its own workload | OpenAI's directional lean-prompt study |\nProjected |\nA falsifiable hypothesis awaiting repository runs | 5–15% relative score uplift on eligible tasks |\n\nThe machine-readable ledger is [ docs/claim-evidence.csv](/RealAhmedOsama/Luna-Forge/blob/main/docs/claim-evidence.csv). The narrative rules are in\n\n[.](/RealAhmedOsama/Luna-Forge/blob/main/docs/EVIDENCE_LEDGER.md)\n\n`docs/EVIDENCE_LEDGER.md`\n\nNote\n\nThe 5–15% range is not a completed benchmark, statistical confidence interval, or promise. It is a pre-benchmark engineering hypothesis with **0.65 judgment confidence**. The included protocol is designed to prove, narrow, or reject it.\n\nThe reviewed repository presents these files as captured system prompts. Luna Forge treats them as **unverified third-party snapshots**, not authenticated vendor documentation. Integrity anchors prove which snapshot was reviewed; they do not prove the repository's provenance claim.\n\n| Snapshot | Lines | Portable / distilled | Portable share | Token-volume basis | Integrity anchor |\n|---|---|---|---|---|---|\n| Claude Fable 5 | 3,736 | 135 | 3.61% | ~57,832 | SHA-256 `d9943f…3b375` |\n| GPT-5.6 Sol Extra High | 2,662 | 141 | 5.30% | ~28,616 | SHA-256 `ac9bb8…90d98` |\n| Kimi K3 | 611 | 25 | 4.09% | ~8,800–9,011 | Git blob SHA-1 `d54346…001b` |\nCombined |\n7,009 |\n301 |\n4.29% |\n~95,248–95,459 |\nThree anchors |\n\n| Disposition | Lines | Meaning |\n|---|---|---|\n`KEEP_PRINCIPLE` |\n46 | Directly portable execution principle |\n`DISTILL` |\n255 | Useful idea rewritten into a host-neutral rule |\n`DROP_SCHEMA` |\n3,627 | Tool or function schema supplied by another host |\n`DROP_PRODUCT` |\n1,118 | Product, UI, path, or vendor-specific behavior |\n`DEFER_HOST_POLICY` |\n178 | Safety or policy that must remain host-owned |\n`DROP_EXAMPLE` |\n155 | Large example corpus that duplicates a principle |\n`DROP_RUNTIME` |\n37 | Identity, date, classifier, or runtime plumbing |\n`DROP_PERSONAL` |\n5 | Embedded personal metadata |\n`IGNORE` |\n1,588 | Blank or structural lines retained for complete physical coverage |\nTotal |\n7,009 |\n100% decision coverage |\n\nLuna Forge excludes:\n\n- foreign tool and connector schemas;\n- vendor identity, model marketing, product UI behavior, and runtime metadata;\n- host-specific safety and policy that Codex already owns;\n- personal context and unrelated user metadata;\n- artifact-rendering tags, sandbox paths, app-specific protocols, and hidden frontend contracts;\n- examples that consume context without adding a new execution rule;\n- any instruction that assumes a capability not proven in the current environment.\n\nThis is why Luna Forge is an original workflow rather than a prompt compilation.\n\nKimi added the most value where execution control intersects context efficiency. Only **25 of 611 lines (4.09%)** were retained or distilled.\n\n| Kimi-derived mechanism | Luna Forge implementation | Failure mode targeted |\n|---|---|---|\n| Milestone progress on long work | Short updates only at material findings, decisions, blockers, or completed phases | Agent appears to disappear or floods the user with commands |\n| Outcome over machinery | Final report leads with changed behavior, proof, risk, and commit state | Tool transcript hides whether acceptance was actually met |\n| Immediate correction | Contradicted hypotheses are replaced as soon as evidence disproves them | Patch is forced to match stale issue wording |\n| Time-stability gate | Version-sensitive assumptions are verified from current authoritative sources | Stale SDK, API, pricing, policy, or role claims |\n| Capability availability gate | A tool, path, API, file, or permission must be observed before use | Invented capabilities and invalid commands |\n| Progressive skill loading | Domain references load at the stage that needs them | Context pollution from irrelevant guidance |\n| Active-context authority | Task contract and repository evidence outrank passive background material | Irrelevant context steers implementation |\n\nKimi-specific tool registries, plugin paths, rendering tags, sandbox conventions, website-delivery rules, and **476 schema lines** were rejected.\n\nSee [ docs/KIMI_REVIEW.md](/RealAhmedOsama/Luna-Forge/blob/main/docs/KIMI_REVIEW.md) for the focused analysis.\n\nThe two earlier snapshots are anchored by SHA-256. Kimi is anchored by the exact Git blob SHA-1 returned by GitHub.\n\nThe first two snapshots additionally have **6,398 exact per-line content_sha12 fingerprints** in\n\n[. Kimi is not redistributed and is therefore verified at whole-blob level; each Kimi decision locator still binds the blob anchor, line number, rule, and action.](/RealAhmedOsama/Luna-Forge/blob/main/docs/source-line-fingerprints-first-two.csv)\n\n`docs/source-line-fingerprints-first-two.csv`\n\nEvery source line from `1`\n\nthrough the source's final physical line receives one deterministic decision row. The validator rejects:\n\n- missing or duplicated lines;\n- unexpected source names or line ranges;\n- unknown actions or rules;\n- changed snapshot anchors;\n- changed decision locators;\n- totals that do not reproduce the published statistics.\n\nThe audit CSV intentionally contains **no prompt text**. Its schema is:\n\n```\nsource\nline\nrule_id\naction\nreason\nsnapshot_integrity_type\nsnapshot_integrity\ndecision_locator_sha12\n```\n\nA source idea survives only when it:\n\n- improves bounded repository execution;\n- remains valid in Codex without a foreign host feature;\n- does not duplicate Codex host policy or repository instructions;\n- can be represented compactly as a behavior, gate, or proof requirement;\n- maps to an observable implementation location;\n- can be evaluated through repository evidence or run behavior.\n\n[ docs/principle-traceability.csv](/RealAhmedOsama/Luna-Forge/blob/main/docs/principle-traceability.csv) maps all\n\n**301** retained or distilled lines into the Skill, agent, references, validator, or eval suite. Validation requires exact one-time coverage: no missing portable line and no double counting.\n\nStatic validation can prove package consistency, audit coverage, cost arithmetic, and release integrity. It cannot prove a quality uplift. That requires paired repository executions under controlled conditions, so quality claims are gated by [ docs/BENCHMARK_PROTOCOL.md](/RealAhmedOsama/Luna-Forge/blob/main/docs/BENCHMARK_PROTOCOL.md).\n\nRead the complete method in [ docs/METHODOLOGY.md](/RealAhmedOsama/Luna-Forge/blob/main/docs/METHODOLOGY.md) and the full report in\n\n[.](/RealAhmedOsama/Luna-Forge/blob/main/docs/REVIEW_REPORT.md)\n\n`docs/REVIEW_REPORT.md`\n\nA **Skill** is the smallest correct authoring unit because Luna Forge is one reusable workflow with no required MCP server. Codex Skills also support progressive disclosure: the workflow is loaded when selected, while task-specific references can remain out of context until needed.\n\nThe custom agent binds the workflow to GPT-5.6 Luna with a bounded worker profile:\n\n```\nname = \"luna_worker\"\nmodel = \"gpt-5.6-luna\"\nmodel_reasoning_effort = \"high\"\nsandbox_mode = \"workspace-write\"\n```\n\nA Plugin may become useful later for broad distribution or bundled connectors. It is unnecessary overhead for the current package.\n\n``` php\nflowchart TD\n    U[Engineering request] --> S{Bounded, owned, observable?}\n    S -->|No| E[Recon, split, or escalate]\n    S -->|Yes| C[Micro-contract]\n    C --> A[Authority and approval boundaries]\n    A --> G[Capability and freshness gates]\n    G --> R[Targeted repository evidence]\n    R --> B[Baseline or reproduction]\n    B --> H{Hypothesis supported?}\n    H -->|No| X[Correct assumption immediately]\n    X --> R\n    H -->|Yes| P[Smallest defensible patch]\n    P --> V[Focused tests, compiler, analyzers]\n    V --> D[Adversarial diff review]\n    D --> Q{Acceptance proven?}\n    Q -->|Bounded correction| P\n    Q -->|Scope or authority blocker| E\n    Q -->|Yes| K[Focused local commit]\n    K --> O[Outcome-first evidence report]\n    O --> N[Never push automatically]\n```\n\nBefore editing, the worker establishes:\n\n```\nGoal\nAuthorized scope\nAcceptance evidence\nNon-goals\nApproval boundaries\nRisk flags\nValidation commands\nDelivery requirement\n```\n\nThat contract becomes the task's routing, scope, and completion boundary.\n\n```\nContract\n→ Verify authority\n→ Verify capability and freshness\n→ Gather causal evidence\n→ Establish baseline\n→ Patch minimally\n→ Prove with deterministic checks\n→ Review the full diff adversarially\n→ Commit locally when authorized\n→ Report outcome and evidence\n```\n\nOnly the relevant domain file is loaded:\n\n| Reference | Loaded when |\n|---|---|\n`task-routing.md` |\nThe task is broad, ambiguous, cross-cutting, or delegated |\n`engineering-loop.md` |\nA non-trivial implementation or bug fix begins |\n`context-budget.md` |\nThe repository, files, logs, or tool output are large |\n`research-verification.md` |\nExternal facts are current, unfamiliar, or version-sensitive |\n`dotnet-10.md` |\nC# or .NET work is in scope |\n`risk-and-rollback.md` |\nDatabase, auth, tenancy, billing, concurrency, production, secrets, or destructive work is involved |\n`git-delivery.md` |\nStaging, commit, or handoff is required |\n`output-contracts.md` |\nFinal delivery or review findings are prepared |\n\nLuna Forge does not attempt to manufacture model capability. It reallocates a smaller model's attention away from avoidable failure modes and toward repository truth.\n\n| Mechanism | Failure targeted | Observable metric |\n|---|---|---|\n| Suitability gate | Luna starts work that requires unresolved frontier reasoning | Correct recon or escalation rate |\n| Micro-contract | Missing acceptance, scope, non-goals, or approvals | Contract compliance |\n| Capability gate | Invented tools, paths, APIs, or permissions | Invalid-capability attempt rate |\n| Freshness gate | Stale external assumptions | Authoritative-source evidence rate |\n| Evidence before editing | Symptom patch or wrong ownership theory | Reproduction and causal-proof score |\n| Immediate correction | Persistence after the premise is disproved | Disproven-premise persistence rate |\n| Smallest defensible patch | Unrelated cleanup and regression surface | Changed files, diff size, scope violations |\n| Validation ladder | Confident but unsupported completion | Independent acceptance rate |\n| Adversarial diff review | Missed edge cases or accidental changes | Post-run reviewer findings |\n| One-worker rule | Duplicate scans and coordination overhead | Repeated reads and total tokens |\n| Progressive references | Irrelevant prompt mass | Activated context and input tokens |\n| Outcome-first delivery | Process narration hides proof | Human-review minutes and evidence completeness |\n\nThe worker gets one bounded correction pass. Repeated retries without new evidence trigger escalation instead of unbounded token spend.\n\n| Layer | Approximate tokens | Loading behavior |\n|---|---|---|\nCore `SKILL.md` |\n2,288 | Loaded when invoked |\n`luna_worker` instructions |\n676 | Loaded for the custom agent |\nActivated core |\n2,964 |\nNormal baseline |\n| Eight references | 6,177 total | Loaded only when relevant |\nAll content worst case |\n9,141 |\nUnrealistic upper bound |\n\n```\nSource estimate: 95,248–95,459 tokens\nActivated core:            ~2,964 tokens\n\nCore reduction = 1 - activated_core / source_estimate\n               = 96.89–96.90%\nAll references loaded: ~9,141 tokens\nWorst-case reduction:  90.40–90.42%\n```\n\nThese are context-volume results, not quality results. Their practical purpose is to let Luna reach code, tests, and task evidence before irrelevant instruction mass consumes its budget.\n\nOpenAI separately reports that leaner prompts improved a sample of internal coding-agent evaluation scores by roughly **10–15%**, while reducing total tokens by **41–66%** and cost by **33–67%**. OpenAI describes those results as directional and workload-dependent. Luna Forge uses them as external support for the design direction, not as proof of its own uplift.\n\nAPI dollars and Codex credits are separate pricing surfaces and are never mixed into one percentage.\n\nOfficial per-million-token rates verified on 2026-08-05:\n\n| Model | Input | Cached input | Output |\n|---|---|---|---|\n| GPT-5.6 Sol | $5.00 | $0.50 | $30.00 |\n| GPT-5.6 Terra | $2.00 | $0.20 | $12.00 |\n| GPT-5.6 Luna | $0.20 | $0.02 | $1.20 |\n\nEvery Luna category is `0.04 ×`\n\nSol.\n\n```\nEqual-token saving = 1 - 0.04 = 0.96 = 96%\n```\n\nVerified below-threshold example:\n\n```\n100,000 input tokens + 10,000 output tokens\nSol:  $0.50 + $0.30  = $0.800\nLuna: $0.02 + $0.012 = $0.032\nSaving: $0.768 = 96%\n```\n\nFor API requests with more than 272K input tokens, OpenAI applies `2×`\n\ninput and `1.5×`\n\noutput pricing to the full request. Cache writes are billed at `1.25×`\n\nthe uncached input rate. The calculator models both rules; separately metered tools remain additional costs.\n\nVerified long-context example:\n\n```\n1,000,000 input tokens + 100,000 output tokens\nSol:  ($5.00 × 2) + ($3.00 × 1.5) = $14.50\nLuna: ($0.20 × 2) + ($0.12 × 1.5) =  $0.58\nSaving: $13.92 = 96%\n```\n\nOfficial per-million-token credit rates verified on 2026-08-05:\n\n| Model | Input | Cached input | Output |\n|---|---|---|---|\n| GPT-5.6 Sol | 125 | 12.5 | 750 |\n| GPT-5.6 Terra | 50 | 5 | 300 |\n| GPT-5.6 Luna | 5 | 0.5 | 30 |\n\nEvery Luna category is also `0.04 ×`\n\nSol.\n\n```\nEqual-token saving = 1 - 0.04 = 0.96 = 96%\n```\n\nVerified example:\n\n```\n100,000 input tokens + 10,000 output tokens\nSol:  12.5 + 7.5 = 20.0 credits\nLuna:  0.5 + 0.3 =  0.8 credits\nSaving: 19.2 credits = 96%\n```\n\nThe current Codex rate card states that Codex does not charge for cache writes. Fast mode consumes credits at a higher rate where supported.\n\nAt a 4% equal-token ratio, Luna may consume up to five times the weighted token usage of the Sol reference and still retain an 80% reduction:\n\n```\n0.04 × 5.00 = 0.20\n```\n\nThe five-times figure is a maximum cost envelope, not a recommended token target. Parent-agent usage, retries, separately metered tools, fast-mode multipliers, and repair work consume part of that headroom.\n\n```\nsuccessful_task_cost = total cost of every attempt / independently accepted tasks\n```\n\nA cheap failed run followed by an expensive repair is not a saving. The benchmark therefore records acceptance, retries, human-review time, and repair cost—not token price alone.\n\nRun the unit-tested calculator:\n\n```\npython scripts/benchmark_cost.py --basis api-usd --compare\npython scripts/benchmark_cost.py --basis codex-credits --compare\n```\n\nSee [ docs/cost-model.md](/RealAhmedOsama/Luna-Forge/blob/main/docs/cost-model.md) for formulas and caveats.\n\nWarning\n\nRate cards, plan limits, long-context multipliers, fast modes, and tool charges can change. Recheck official pricing before making a financial commitment.\n\n```\nProjected relative score uplift: 5–15%\nConfidence:                      0.65 judgment confidence\nComparator:                      Unstructured GPT-5.6 Luna\nEligible work:                   Clear, bounded, observable repository tasks\nStatus:                          Projected, not measured\n```\n\n- OpenAI's external directional result reports roughly 10–15% higher coding-agent eval scores after prompt simplification.\n- Luna Forge removes approximately 96.9% of the studied source context from the normal activated core.\n- It adds explicit routing, capability, freshness, evidence, scope, verification, and correction controls.\n- Those controls also add overhead, especially on trivial tasks.\n- Luna remains a cost-optimized model; the workflow cannot erase its limits on ambiguity and long-horizon synthesis.\n\nThe lower bound discounts for overhead and transfer uncertainty. The upper bound is anchored to the external directional result rather than extrapolating beyond it.\n\nThe range must be reduced or rejected when representative paired runs show:\n\n- no material composite-score improvement;\n- lower independent acceptance;\n- higher hard-failure or scope-violation rates;\n- more tokens without a reliability gain;\n- human-review overhead that erases the cost advantage;\n- repeated Sol repair after Luna execution;\n- task categories that consistently require unresolved architecture or product judgment.\n\nThe target is not the highest raw score at any price. It is a higher rate of accepted work per cost unit while preserving correctness and scope.\n\nThe package ships **21 controlled cases** across routing, implementation, .NET, tenancy, concurrency, approvals, research, Git, verification, capability, freshness, epistemic correction, communication, and cost control.\n\n| Configuration | Model | Skill | Purpose |\n|---|---|---|---|\n`luna-baseline` |\nGPT-5.6 Luna | None | Unstructured Luna comparator |\n`luna-forge` |\nGPT-5.6 Luna | Explicit `$luna-forge` |\nTreatment |\n`sol-reference` |\nGPT-5.6 Sol | None | Frontier reference, not the primary uplift comparator |\n\n- independent acceptance rate;\n- hard-failure rate;\n- median composite score;\n- median successful-task API cost and Codex-credit cost;\n- scope violations and unauthorized writes;\n- retries and repair attempts;\n- input, cached-input, and output tokens;\n- human-review minutes;\n- latency and diff size.\n\nThe benchmark protocol requires at least:\n\n**30 paired runs** across at least 10 representative repository cases;- at least three runs per case and configuration for the initial gate;\n- identical repository snapshots and controlled permissions;\n- hidden independent acceptance checks;\n- no material increase in hard failures;\n- no material correctness regression;\n- lower successful-task cost;\n- publication of the raw scorecard before aggregate claims.\n\nFor a durable public claim, [ docs/BENCHMARK_PROTOCOL.md](/RealAhmedOsama/Luna-Forge/blob/main/docs/BENCHMARK_PROTOCOL.md) recommends at least five paired runs per task and configuration.\n\nRun the analyzer:\n\n```\npython scripts/analyze_evals.py evals/scorecard.csv\n```\n\nThe analyzer reports configuration summaries and deterministic bootstrap intervals for median score. The packaged scorecard is intentionally empty; it returns `benchmark_complete: false`\n\nrather than inventing a result.\n\nFull benchmark assets:\n\n`docs/BENCHMARK_PROTOCOL.md`\n\n`evals/cases.yaml`\n\n`evals/rubric.md`\n\n`evals/acceptance-gates.md`\n\n`evals/runbook.md`\n\n`evals/scorecard.csv`\n\n| Claim | Confidence | Basis | Main uncertainty |\n|---|---|---|---|\n| Package structure and release integrity | 0.99 |\nValidator, unit tests, manifest, deterministic rebuild, extraction recheck | Undiscovered validator defect |\n| API equal-token saving is 96% at reviewed rates | 0.99 |\nPublished rates + exact arithmetic + unit tests | Future rate, long-context, cache-write, or tool-charge changes |\n| Codex-credit equal-token saving is 96% at reviewed rates | 0.99 |\nPublished rates + exact arithmetic + unit tests | Future rate, fast-mode, or plan-specific changes |\n| One decision exists for every 7,009 reviewed line | 0.99 |\nAudit CSV, range checks, action totals | Source provenance, not row coverage |\n| First-two per-line fingerprints cover 6,398 lines | 0.99 |\nFingerprint CSV + exact validator coverage | Kimi has only whole-blob anchoring |\n| Semantic portability classification is reasonable | 0.90 |\nRule map, rationales, traceability, review | Human judgment |\n| Source context is ~95,248–95,459 tokens | 0.92 |\nTransparent character and size heuristic | Not measured with the model tokenizer |\n| Activated core is ~2,964 tokens | 0.98 |\nCharacter heuristic over exact package files | Tokenizer variance |\n| Luna Forge improves eligible-task score by 5–15% | 0.65 |\nMechanism analysis + external directional evidence | No completed repository benchmark |\n| Luna Forge beats Sol or Fable on every task | 0.00 |\nUnsupported and explicitly prohibited | Model capability differences |\n\nThese confidence values are engineering judgments, not statistical intervals or Bayesian posteriors.\n\n- A current Codex release with Agent Skills and custom-agent support.\n- Python 3.11 or newer.\n- No third-party Python packages.\n\n```\npython -m unittest discover -s tests -v\npython scripts/validate.py\npython scripts/install.py --scope user --dry-run\npython scripts/install.py --scope user\n```\n\nInstalled paths:\n\n```\n~/.agents/skills/luna-forge/\n~/.codex/agents/luna-worker.toml\npython scripts/install.py \\\n  --scope project \\\n  --project-root /absolute/path/to/repository \\\n  --dry-run\n\npython scripts/install.py \\\n  --scope project \\\n  --project-root /absolute/path/to/repository\n```\n\nThe installer validates first, treats identical files as a no-op, refuses conflicting files by default, and creates timestamped backups before an explicitly authorized `--force`\n\nreplacement. It does not edit `~/.codex/config.toml`\n\n, delete unrelated files, commit, or push.\n\nSee [ INSTALL.md](/RealAhmedOsama/Luna-Forge/blob/main/INSTALL.md) or use\n\n[as a self-contained Codex task.](/RealAhmedOsama/Luna-Forge/blob/main/CODEX_INSTALL_PROMPT.md)\n\n`CODEX_INSTALL_PROMPT.md`\n\n```\n$luna-forge\n\nGoal:\nFix cancellation propagation in the campaign dispatch path.\n\nAuthorized scope:\n- src/Campaigns\n- related unit and integration tests only\n\nAcceptance evidence:\n- Add a focused regression test.\n- Prove the test fails against the baseline when feasible.\n- The regression test and relevant build pass after the fix.\n- The final diff contains no unrelated changes.\n\nNon-goals:\n- No public API redesign.\n- No package changes.\n- No schema or production configuration changes.\n\nDelivery:\nCreate one focused local Git commit after validation. Never push automatically.\nResolve only the architecture or requirement ambiguity that Luna should not own.\nThen delegate one complete bounded task capsule to luna_worker.\nDo not duplicate the worker's repository scan.\nAfter it returns, inspect the critical claims, final diff, and acceptance evidence.\nNever push automatically.\n\n<complete task capsule>\n$luna-forge\n\nReview the current branch for correctness defects in the changed execution path.\nDo not edit, stage, commit, or push.\nReturn only evidence-backed findings with file and line references, or explicitly state that no finding was validated.\n$luna-forge\n\nThe request is not yet safe to implement.\nPerform bounded reconnaissance only.\nIdentify the real execution path, unresolved decisions, approval boundaries, and one to three implementation slices with observable acceptance criteria.\nDo not modify files.\n```\n\nStay in reconnaissance, split the task, or escalate when the work requires:\n\n- open-ended architecture across multiple subsystems;\n- unresolved product, pricing, legal, policy, or risk judgment;\n- multi-repository coordination without explicit ownership boundaries;\n- destructive migration, production write, deletion, or secret rotation without authorization;\n- an unavailable tool, permission, environment, or authoritative fact;\n- speculative fixing without reproduction, invariant, or causal evidence;\n- a long-horizon plan whose correctness cannot be proved in a bounded loop.\n\nLuna Forge is deliberately selective. Routing a task away from Luna can be the correct result.\n\n```\npython scripts/audit_sources.py \\\n  --metadata-only \\\n  --output-csv /tmp/line-by-line-audit.csv \\\n  --output-summary /tmp/audit-summary.json\n\ncmp docs/line-by-line-audit.csv /tmp/line-by-line-audit.csv\ncmp docs/audit-summary.json /tmp/audit-summary.json\n```\n\nWhen the exact source snapshots are available locally, pass them to `scripts/audit_sources.py`\n\n; the script verifies their integrity before producing the decision map.\n\n```\npython scripts/generate_metrics.py\npython -m unittest discover -s tests -v\npython scripts/validate.py\npython scripts/validate.py --json\npython scripts/analyze_evals.py evals/scorecard.csv\npython scripts/build_release.py --output-dir /absolute/output/path\n```\n\nThe release builder:\n\n- removes transient bytecode;\n- regenerates the audit and metrics;\n- rebuilds\n`MANIFEST.sha256`\n\n; - runs all unit tests and validation;\n- runs seven isolated installer lifecycle checks;\n- creates a deterministic ZIP with fixed timestamps and a single\n`luna-forge/`\n\nroot; - builds the ZIP a second time and requires byte-for-byte equality;\n- rejects path traversal and symlink archive members;\n- performs ZIP CRC validation and safe extraction;\n- compares every extracted package file byte-for-byte with the source tree;\n- reruns tests, validation, and all seven installer checks on the extracted package;\n- writes the archive SHA-256 and a machine-readable validation report.\n\nThat is **18 automated unit tests**, **14 isolated installer lifecycle checks**, two complete package validation passes, a deterministic rebuild comparison, safe extraction, and a source-to-archive round trip in every release.\n\nThe validator checks, among other invariants:\n\n- package version consistency;\n- required file presence;\n- English-only package-authored text;\n- no bundled source-prompt files;\n- valid Skill frontmatter and local references;\n- custom-agent TOML schema and Luna model settings;\n- explicit Skill invocation and no nested agents;\n- no automatic push instruction;\n- 7,009 unique source-line decisions with exact action totals;\n- 6,398 exact per-line fingerprints for the first two sources;\n- complete one-time traceability for all 301 portable lines;\n- 21 eval cases and benchmark assets;\n- cost formulas and known price vectors;\n- README local links, JSON documents, and SVG XML;\n- claim-ledger evidence levels and prohibited claims;\n- manifest hashes for every packaged file.\n\nThe final archive is not considered valid merely because it can be opened. It must pass the same validator and installer lifecycle after extraction.\n\nThe GitHub-ready archive preserves the complete local repository, including `.git`\n\n, eleven focused commits on `main`\n\n, the annotated `v2.2.1`\n\ntag, and a preconfigured `origin`\n\nfor `RealAhmedOsama/luna-forge`\n\n.\n\n```\ngit status --short --branch\ngit log --oneline --decorate --graph --all\ngit tag --list --format='%(refname:short) %(subject)'\ngit remote -v\n```\n\nAfter creating an empty GitHub repository named `luna-forge`\n\nunder `RealAhmedOsama`\n\n, publication remains an explicit maintainer action:\n\n```\ngit push -u origin main\ngit push origin v2.2.1\n```\n\nThe branch push starts validation. The tag push starts the release workflow, which rebuilds and revalidates the deterministic distribution archive before creating the GitHub Release. No package script pushes commits or tags. See [ PUBLISHING.md](/RealAhmedOsama/Luna-Forge/blob/main/PUBLISHING.md) for the complete handoff.\n\n```\nluna-forge/\n├── VERSION                           Single package version source\n├── README.md                         GitHub project page and evidence summary\n├── INSTALL.md                        Installation and verification guide\n├── CODEX_INSTALL_PROMPT.md           Self-contained Codex installation task\n├── CHANGELOG.md\n├── CONTRIBUTING.md\n├── SECURITY.md\n├── CODE_OF_CONDUCT.md\n├── CITATION.cff\n├── PUBLISHING.md\n├── NOTICE.md\n├── LICENSE\n├── .editorconfig\n├── .gitattributes\n├── .gitignore\n├── .github/                         Issues, ownership, CI, and tagged releases\n├── MANIFEST.sha256                   Hash for every packaged file\n├── codex/agents/\n│   └── luna-worker.toml              GPT-5.6 Luna custom agent\n├── skill/luna-forge/\n│   ├── SKILL.md                      Core bounded-execution workflow\n│   ├── agents/openai.yaml            Skill metadata; implicit invocation disabled\n│   └── references/                   Eight progressive domain references\n├── docs/\n│   ├── REVIEW_REPORT.md              Full research and engineering report\n│   ├── METHODOLOGY.md                Source audit and synthesis method\n│   ├── BENCHMARK_PROTOCOL.md         Quality-claim promotion protocol\n│   ├── IMPACT_MODEL.md               Mechanisms and quality hypothesis\n│   ├── EVIDENCE_LEDGER.md            Claim-by-claim evidence boundaries\n│   ├── KIMI_REVIEW.md                Kimi-specific contribution review\n│   ├── line-by-line-audit.csv        7,009 deterministic line decisions\n│   ├── source-line-fingerprints-first-two.csv\n│   │                                     6,398 exact per-line content fingerprints\n│   ├── principle-traceability.csv    Portable-line implementation map\n│   ├── audit-summary.json            Machine-readable audit totals\n│   ├── metrics.json                  Machine-readable project metrics\n│   ├── claim-evidence.csv            Machine-readable claim ledger\n│   └── assets/\n│       ├── luna-forge-hero.svg\n│       └── evidence-funnel.svg\n├── evals/\n│   ├── cases.yaml                    21 controlled task cases\n│   ├── rubric.md                     100-point rubric and hard failures\n│   ├── acceptance-gates.md           Per-run and benchmark gates\n│   ├── runbook.md                    Controlled benchmark procedure\n│   └── scorecard.csv                 Raw-run capture template\n├── scripts/\n│   ├── audit_sources.py              Deterministic source decision-map generator\n│   ├── analyze_evals.py              Paired-run benchmark analyzer\n│   ├── benchmark_cost.py             API and Codex cost calculator\n│   ├── generate_metrics.py           Derived metric generator\n│   ├── validate.py                   Package integrity and consistency validator\n│   ├── build_release.py              Deterministic release and round-trip builder\n│   └── install.py                    Safe user or repository installer\n└── tests/\n    ├── test_audit_rules.py\n    ├── test_cost_model.py\n    ├── test_eval_analysis.py\n    └── test_repository_metadata.py\n```\n\n- An original, compact execution workflow.\n- A reproducible study of portable agent-execution mechanisms.\n- A cost and benchmark framework for bounded engineering work.\n- A Skill and custom agent subordinate to Codex host policy, repository instructions, and user authorization.\n\n- An authenticated vendor system prompt.\n- A merged copy of the reviewed snapshots.\n- A bypass for safety, approvals, sandboxing, or repository policy.\n- A guarantee of universal model superiority.\n- A completed empirical quality benchmark.\n- A replacement for tests, code review, deployment controls, or rollback planning.\n\n- The third-party source repository's provenance was not independently authenticated.\n- Portability classification includes human semantic judgment.\n- Kimi has whole-blob integrity anchoring rather than bundled per-line content fingerprints.\n- Token counts use a transparent character/size heuristic, not the GPT-5.6 tokenizer.\n- OpenAI's lean-prompt finding is external, directional, and workload-specific.\n- Models, pricing, multipliers, and plan behavior can change.\n- Repository results depend on task selection, harness, tools, tests, permissions, and independent review.\n- A structured workflow can reduce avoidable failure; it cannot remove fundamental model capability differences.\n\n- No automatic push.\n- No nested or parallel agents inside\n`luna_worker`\n\n. - No destructive, production, secret, dependency, schema, deletion, or external write without explicit authorization.\n- No success claim without observed evidence.\n- No invented tool, file, path, API, command result, deployment state, or citation.\n- No source prompt text distributed in the package.\n\n[GPT-5.6 model guidance](https://developers.openai.com/api/docs/guides/latest-model)— Luna positioning and the directional lean-prompt study.[GPT-5.6 Luna](https://developers.openai.com/api/docs/models/gpt-5.6-luna)— API pricing and workload positioning.[GPT-5.6 Sol](https://developers.openai.com/api/docs/models/gpt-5.6-sol)— frontier-model positioning and API pricing.[GPT-5.6 Terra](https://developers.openai.com/api/docs/models/gpt-5.6-terra)— balanced-tier positioning and API pricing.[Codex Skills](https://developers.openai.com/codex/skills)— reusable workflows and progressive disclosure.[Codex subagents and custom agents](https://developers.openai.com/codex/agent-configuration/subagents)— task fit, reasoning effort, token overhead, and agent configuration.[Codex rate card](https://help.openai.com/en/articles/20001106-codex-rate-card)— token-credit rates and plan caveats.\n\nThe third-party repository is used only as an analysis corpus. Luna Forge does not authenticate its provenance and does not redistribute the reviewed prompt text.\n\n**Use the smallest model that can reliably satisfy the contract—then prove the result.**\n\nBuilt and maintained by [Ahmed Osama](https://github.com/RealAhmedOsama).\n\nLuna Forge v2.2.1 · English-only package · MIT-licensed original workflow · Never pushes automatically", "url": "https://wpnews.pro/news/luna-forge", "canonical_source": "https://github.com/RealAhmedOsama/Luna-Forge", "published_at": "2026-08-04 22:08:43+00:00", "updated_at": "2026-08-04 22:23:11.823543+00:00", "lang": "en", "topics": ["artificial-intelligence", "ai-tools", "developer-tools", "ai-research"], "entities": ["Luna Forge", "GPT-5.6 Luna", "OpenAI", "Sol", "Claude Fable", "RealAhmedOsama"], "alternates": {"html": "https://wpnews.pro/news/luna-forge", "markdown": "https://wpnews.pro/news/luna-forge.md", "text": "https://wpnews.pro/news/luna-forge.txt", "jsonld": "https://wpnews.pro/news/luna-forge.jsonld"}}