Self-evolving second brain with 35 AI skills, 10 agents, and people CRM. Closed-loop harness: a V-model verification lifecycle where the worker never grades its own homework. Plus paired anti-slop design skills for marketing and product UI. Works with Claude Code, Cursor, Kiro, Gemini CLI, Codex.
Code Commits Issues Pull requests Wiki Builds Discussions Projects Insights Search Files 8 branches · 8 tags COG-second-brain / skills / closed-loop / references / spec-template.md 1.1 KB
Code Raw Blame Permalink
SPEC-NNN: </h1>
<blockquote>
<p>Lane: <code>tiny|normal|full|bug|backfill</code> · Run: <code>04-projects/harness/runs/<id></code> · Date: YYYY-MM-DD</p>
</blockquote>
<h2>Goal</h2>
<p>One paragraph. What is true when this is done that is not true now.</p>
<h2>Non-goals</h2>
<p>What this deliberately does not cover, so scope creep is visible.</p>
<h2>Acceptance criteria</h2>
<p>Every criterion is <strong>falsifiable</strong>: a named observation either happens or it does not.
"Works well" is not a criterion. "<code>curl -s <url> | grep -q '<string>'</code> exits 0" is.</p>
<table>
<thead>
<tr>
<th>ID</th>
<th>Criterion</th>
<th>Verify method</th>
</tr>
</thead>
<tbody><tr>
<td>AC-01</td>
<td><observable statement></td>
<td><command, screenshot, re-fetch, diff></td>
</tr>
<tr>
<td>AC-02</td>
<td></td>
<td></td>
</tr>
</tbody></table>
<h2>Traceability matrix</h2>
<p>Status: <code>pending</code> at CP-2, <code>built</code> at CP-3, <code>verified</code> once a PASS row exists in the ledger.</p>
<table>
<thead>
<tr>
<th>AC</th>
<th>Task</th>
<th>Evidence row</th>
<th>Status</th>
</tr>
</thead>
<tbody><tr>
<td>AC-01</td>
<td>T-01</td>
<td></td>
<td>pending</td>
</tr>
<tr>
<td>AC-02</td>
<td>T-02</td>
<td></td>
<td>pending</td>
</tr>
</tbody></table>
<h2>Tasks</h2>
<table>
<thead>
<tr>
<th>ID</th>
<th>Task</th>
<th>Covers</th>
</tr>
</thead>
<tbody><tr>
<td>T-01</td>
<td><what gets built></td>
<td>AC-01</td>
</tr>
<tr>
<td>T-02</td>
<td></td>
<td>AC-02</td>
</tr>
</tbody></table>
<h2>Phases (ultragoal only)</h2>
<table>
<thead>
<tr>
<th>Phase</th>
<th>Scope</th>
<th>Covers</th>
<th>State</th>
</tr>
</thead>
<tbody><tr>
<td>P0</td>
<td></td>
<td>AC-01</td>
<td>not started</td>
</tr>
</tbody></table>
<h2>Risks and open questions</h2>
<ul>
<li><risk>: mitigation or the decision needed.</li>
</ul>