-
Notifications
You must be signed in to change notification settings - Fork 119
Expand file tree
/
Copy pathindex.html
More file actions
352 lines (333 loc) · 16.6 KB
/
Copy pathindex.html
File metadata and controls
352 lines (333 loc) · 16.6 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
<!doctype html>
<!-- Generated by scripts/build-loop-pages.mjs. -->
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="description" content="A goal-planner-codex workflow that defines completion up front, tracks proof for every requirement, and prevents partial Codex work from being reported as done." />
<meta name="author" content="3goblack (@Dis_Trackted)" />
<meta name="robots" content="index,follow,max-image-preview:large,max-snippet:-1" />
<meta name="theme-color" content="#faf8f7" />
<meta name="color-scheme" content="light dark" />
<script>
(() => {
const storageKey = "loop-library-theme";
let storedTheme;
try {
storedTheme = window.localStorage.getItem(storageKey);
} catch {
storedTheme = null;
}
const theme =
storedTheme === "light" || storedTheme === "dark"
? storedTheme
: window.matchMedia("(prefers-color-scheme: dark)").matches
? "dark"
: "light";
document.documentElement.dataset.theme = theme;
document
.querySelector('meta[name="theme-color"]')
.setAttribute("content", theme === "dark" ? "#101010" : "#faf8f7");
})();
</script>
<meta property="og:type" content="article" />
<meta property="og:site_name" content="Loop Library" />
<meta property="og:title" content="Codex Completion Contract and Evidence Loop | Loop Library" />
<meta property="og:description" content="A goal-planner-codex workflow that defines completion up front, tracks proof for every requirement, and prevents partial Codex work from being reported as done." />
<meta property="og:url" content="https://signals.forwardfuture.ai/loop-library/loops/codex-completion-contract-loop/" />
<meta property="og:image" content="https://signals.forwardfuture.ai/loop-library/assets/social/codex-completion-contract-loop-20260620-7.png" />
<meta property="og:image:secure_url" content="https://signals.forwardfuture.ai/loop-library/assets/social/codex-completion-contract-loop-20260620-7.png" />
<meta property="og:image:type" content="image/png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:image:alt" content="The Codex completion-contract loop — Forward Future Loop Library" />
<meta property="article:published_time" content="2026-06-19" />
<meta property="article:modified_time" content="2026-06-19" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Codex Completion Contract and Evidence Loop | Loop Library" />
<meta name="twitter:description" content="A goal-planner-codex workflow that defines completion up front, tracks proof for every requirement, and prevents partial Codex work from being reported as done." />
<meta name="twitter:image" content="https://signals.forwardfuture.ai/loop-library/assets/social/codex-completion-contract-loop-20260620-7.png" />
<meta name="twitter:image:alt" content="The Codex completion-contract loop — Forward Future Loop Library" />
<link rel="canonical" href="https://signals.forwardfuture.ai/loop-library/loops/codex-completion-contract-loop/" />
<link rel="sitemap" type="application/xml" href="https://signals.forwardfuture.ai/loop-library/sitemap.xml" />
<link rel="alternate" type="application/atom+xml" title="Loop Library updates" href="https://signals.forwardfuture.ai/loop-library/feed.xml" />
<link rel="alternate" type="application/json" title="Loop Library catalog" href="https://signals.forwardfuture.ai/loop-library/catalog.json" />
<link rel="alternate" type="text/markdown" title="Loop Library catalog in Markdown" href="https://signals.forwardfuture.ai/loop-library/catalog.md" />
<link rel="alternate" type="text/plain" title="Loop Library agent instructions" href="https://signals.forwardfuture.ai/loop-library/llms.txt" />
<link rel="alternate" type="text/plain" title="Loop Library plain-text catalog" href="https://signals.forwardfuture.ai/loop-library/catalog.txt" />
<link rel="help" href="https://signals.forwardfuture.ai/loop-library/agents/" />
<link rel="icon" type="image/png" href="../../assets/favicon.png" />
<link rel="stylesheet" href="../../styles.css?v=20260620-primary-nav" />
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "BreadcrumbList",
"@id": "https://signals.forwardfuture.ai/loop-library/loops/codex-completion-contract-loop/#breadcrumbs",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Loop Library",
"item": "https://signals.forwardfuture.ai/loop-library/"
},
{
"@type": "ListItem",
"position": 2,
"name": "The Codex completion-contract loop",
"item": "https://signals.forwardfuture.ai/loop-library/loops/codex-completion-contract-loop/"
}
]
},
{
"@type": "Article",
"@id": "https://signals.forwardfuture.ai/loop-library/loops/codex-completion-contract-loop/#article",
"headline": "The Codex completion-contract loop",
"description": "A goal-planner-codex workflow that defines completion up front, tracks proof for every requirement, and prevents partial Codex work from being reported as done.",
"url": "https://signals.forwardfuture.ai/loop-library/loops/codex-completion-contract-loop/",
"mainEntityOfPage": "https://signals.forwardfuture.ai/loop-library/loops/codex-completion-contract-loop/",
"datePublished": "2026-06-19",
"dateModified": "2026-06-19",
"articleSection": "AI coding agent workflow",
"keywords": [
"Codex Goal",
"completion contract",
"evidence audit",
"definition of done",
"false completion prevention"
],
"isBasedOn": "https://github.com/ranvier2d2/skills-share/tree/main/skills/goal-planner-codex",
"image": {
"@type": "ImageObject",
"url": "https://signals.forwardfuture.ai/loop-library/assets/social/codex-completion-contract-loop-20260620-7.png",
"width": 1200,
"height": 630
},
"author": {
"@type": "Person",
"name": "3goblack (@Dis_Trackted)"
},
"publisher": {
"@id": "https://signals.forwardfuture.ai/loop-library/#organization"
},
"isPartOf": {
"@id": "https://signals.forwardfuture.ai/loop-library/#collection"
}
},
{
"@type": "Organization",
"@id": "https://signals.forwardfuture.ai/loop-library/#organization",
"name": "Forward Future",
"url": "https://forwardfuture.ai/",
"logo": {
"@type": "ImageObject",
"url": "https://signals.forwardfuture.ai/loop-library/assets/ff-mark.png",
"width": 1920,
"height": 1920
}
}
]
}
</script>
<script src="../../script.js?v=20260621-search-index" defer></script>
<title>Codex Completion Contract and Evidence Loop | Loop Library</title>
</head>
<body>
<a class="skip-link" href="#main">Skip to content</a>
<header class="site-header">
<a class="brand-lockup" href="../../" aria-label="Forward Future Loop Library home">
<img
class="brand-mark"
src="../../assets/favicon.png"
width="32"
height="32"
alt=""
/>
<span class="brand-name">Forward Future</span>
<span class="brand-product">Loop Library</span>
</a>
<nav class="site-nav" aria-label="Primary navigation">
<a href="../../#library" aria-current="page">Loops</a>
<a href="../../learn/">Learn</a>
<a href="../../agents/">For agents</a>
<button
class="theme-toggle"
id="theme-toggle"
type="button"
aria-label="Switch to dark mode"
aria-pressed="false"
>
<svg class="theme-icon theme-icon-light" viewBox="0 0 24 24" aria-hidden="true">
<circle cx="12" cy="12" r="3.5"></circle>
<path d="M12 2v3M12 19v3M4.9 4.9 7 7M17 17l2.1 2.1M2 12h3M19 12h3M4.9 19.1 7 17M17 7l2.1-2.1"></path>
</svg>
<svg class="theme-icon theme-icon-dark" viewBox="0 0 24 24" aria-hidden="true">
<path d="M20 15.2A8.5 8.5 0 0 1 8.8 4a8.5 8.5 0 1 0 11.2 11.2Z"></path>
</svg>
<span class="theme-label theme-label-light">Light</span>
<span class="theme-label theme-label-dark">Dark</span>
</button>
<a class="nav-cta" href="../../#submit">Submit a loop</a>
<a
class="here-now-credit here-now-credit--header"
data-here-now-credit
href="https://here.now/r/signals"
target="_blank"
rel="noopener noreferrer"
aria-label="Hosted by here.now"
>
<img
class="here-now-credit__icon"
src="../../assets/here-now-icon.svg"
alt=""
aria-hidden="true"
/>
<span class="here-now-credit__text">
<small>Hosted by</small>
<strong>here.now</strong>
</span>
</a>
</nav>
<nav class="mobile-site-nav" aria-label="Primary navigation on small screens">
<a href="../../#library" aria-current="page">Loops</a>
<a href="../../learn/">Learn</a>
<a href="../../agents/">For agents</a>
</nav>
</header>
<main class="detail-main page-width" id="main">
<nav class="breadcrumbs" aria-label="Breadcrumb">
<a href="../../">← All loops</a>
</nav>
<article class="loop-detail">
<header class="detail-hero">
<p class="eyebrow">Loop 028</p>
<h1>The Codex completion-contract loop</h1>
<p class="detail-lede">A goal-planner-codex workflow that defines completion up front, tracks proof for every requirement, and prevents partial Codex work from being reported as done.</p>
<p class="detail-byline">
Contributed by <strong>3goblack (@Dis_Trackted)</strong> · <a class="detail-source-link" href="https://github.com/ranvier2d2/skills-share/tree/main/skills/goal-planner-codex" target="_blank" rel="noopener noreferrer">Source</a>
</p>
<div class="share-actions" aria-label="Share this loop">
<button
class="share-action share-action-primary"
type="button"
data-copy-social-post
data-post-text="Try "The Codex completion-contract loop" from the Loop Library: Defines completion up front and requires evidence for every reported result."
data-post-url="https://signals.forwardfuture.ai/loop-library/loops/codex-completion-contract-loop/"
aria-label="Copy a social post about The Codex completion-contract loop"
>
<svg class="share-copy-icon" viewBox="0 0 24 24" aria-hidden="true">
<rect x="8" y="8" width="11" height="11"></rect>
<path d="M16 8V5a1 1 0 0 0-1-1H5a1 1 0 0 0-1 1v10a1 1 0 0 0 1 1h3"></path>
</svg>
<span>Share on social</span>
</button>
</div>
</header>
<div class="detail-stack">
<section class="detail-prompt-card" data-copy-root aria-labelledby="copy-loop">
<div class="detail-prompt-heading">
<div>
<p class="eyebrow">Ready-to-use prompt</p>
<h2 id="copy-loop">Copy the loop</h2>
</div>
<button class="copy-button" type="button">
<span>Copy</span>
</button>
</div>
<p data-prompt>Run $goal-planner-codex [task] for long-running Codex work where partial work could be mistaken for done. Landing a PR and verifying production is one example. Before acting, define every required outcome and its evidence. After each bounded action, mark requirements proved, weak, missing, or contradicted. Complete the Goal only when all are proved; otherwise stop as blocked, stalled, or exhausted. Ask before creating Goal state. Finish with the requirement-to-evidence table, status, owner, and next action.</p>
</section>
<section class="verification-card" aria-labelledby="verify-stop">
<p class="eyebrow">Verify / stop</p>
<div>
<h2 id="verify-stop">Every Codex Goal requirement has current, adequate proof.</h2>
<p>The final audit contains no weak, missing, or contradicted required item; otherwise the work remains open, blocked, or exhausted.</p>
</div>
</section>
<details class="detail-more">
<summary>
<span>Context and guidance</span>
<small>When to use it, steps, safety notes, and related loops</small>
</summary>
<div class="detail-more-body">
<dl class="detail-meta">
<div>
<dt>Published</dt>
<dd><time datetime="2026-06-19">Jun 19, 2026</time></dd>
</div>
<div>
<dt>Updated</dt>
<dd><time datetime="2026-06-19">Jun 19, 2026</time></dd>
</div>
</dl>
<section aria-labelledby="use-when">
<h2 id="use-when">Use this when</h2>
<p>Use this for long-running Codex work, pull requests, runtime checks, or user-visible artifacts where a plausible partial result could be mistaken for completion.</p>
</section>
<section aria-labelledby="run-loop">
<h2 id="run-loop">How to run it</h2>
<ol class="detail-steps">
<li>Recover a measurable definition of done for every ambiguous requirement.</li>
<li>Record the requirements, scope, non-goals, evidence plan, and current status without expanding the requested work.</li>
<li>Execute one bounded action at a time and attach current evidence to each affected requirement.</li>
<li>Audit every requirement before closure and preserve honest blocked, exhausted, stalled, or contradicted states.</li>
</ol>
</section>
<section aria-labelledby="why-it-works">
<h2 id="why-it-works">Why it works</h2>
<p>A durable completion contract keeps the definition of done visible across long sessions. Mapping every requirement to evidence makes false completion easy to detect.</p>
</section>
<section class="implementation-note" aria-labelledby="implementation-note">
<h2 id="implementation-note">Implementation note</h2>
<p>Use $goal-planner-codex only when the user explicitly asks for a Codex Goal or completion audit. Create native Goal state only with approval; ordinary task planning does not need it, and budget exhaustion never counts as success.</p>
</section>
<nav class="related-loops" aria-labelledby="related-heading">
<h2 id="related-heading">Related loops</h2>
<div>
<a class="related-loop-link" href="../ticket-to-pr-ready-loop/">
The ticket-to-PR-ready loop
</a>
<a class="related-loop-link" href="../quality-streak-loop/">
The quality streak loop
</a>
</div>
</nav>
</div>
</details>
</div>
</article>
</main>
<footer class="site-footer">
<div class="page-width footer-inner">
<p><strong>Forward Future</strong> <span>Make the future legible.</span></p>
<div class="footer-actions">
<p>
<a href="../../">Loop Library</a>
<a href="https://forwardfuture.ai/" rel="noopener">forwardfuture.ai</a>
<span>© 2026</span>
</p>
<a
class="here-now-credit here-now-credit--footer"
data-here-now-credit
href="https://here.now/r/signals"
target="_blank"
rel="noopener noreferrer"
aria-label="Hosted by here.now"
>
<img
class="here-now-credit__icon"
src="../../assets/here-now-icon.svg"
alt=""
aria-hidden="true"
/>
<span class="here-now-credit__text">
<small>Hosted by</small>
<strong>here.now</strong>
</span>
</a>
</div>
</div>
</footer>
<div class="toast" id="toast" role="status" aria-live="polite"></div>
</body>
</html>