cyc-stack 0.8.3 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,39 +1 @@
1
- <svg xmlns="http://www.w3.org/2000/svg" width="2020" height="1300" viewBox="0 0 2020 1300" role="img" aria-labelledby="methods-title methods-desc" font-family="Segoe UI, Arial, sans-serif"><title id="methods-title">CYC complete method-selection map</title><desc id="methods-desc">The cyc orchestrator chooses methods by task need. All seventeen supporting methods have a selection condition and output. These are capabilities, not seventeen mandatory steps. Examples are available in each method's accessible description; links open its source instructions.</desc><defs><marker id="select-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto"><path d="M0 0 L10 5 L0 10 Z" fill="#2b69b0"/></marker></defs><rect width="2020" height="1300" fill="white"/><text x="40" y="54" font-size="40" font-weight="800" fill="#16225a">CYC · the full method library</text>
2
- <text x="40" y="96" font-size="22" font-weight="400" fill="#334362">1 orchestrator selects from 17 methods and 15 playbooks. Four stages describe only the common implementation route.</text>
3
- <text x="40" y="134" font-size="19" font-weight="400" fill="#334362">Arrows show selection by need. Rows group responsibilities; they are not an execution sequence. Click a method to read its instructions.</text>
4
- <g data-method="cyc"><a href="../../skills/cyc/SKILL.md"><rect x="40" y="540" width="250" height="180" rx="12" fill="#eaf3ff" stroke="#2b69b0" stroke-width="2"/><text x="60" y="578" font-size="30" font-weight="800" fill="#16225a">/cyc</text><text x="60" y="616" font-size="21" font-weight="700" fill="#334362">Own the outcome</text><text x="60" y="650" font-size="18" font-weight="400" fill="#334362">Choose the playbook</text><text x="60" y="681" font-size="18" font-weight="400" fill="#334362">Load relevant methods</text></a></g>
5
- <path d="M290 630 H320 V217 H350" fill="none" stroke="#2b69b0" stroke-width="2" marker-end="url(#select-arrow)"/>
6
- <rect x="350" y="190" width="1630" height="230" rx="12" fill="#f7f9fc" stroke="#ced9e5"/>
7
- <text x="370" y="219" font-size="21" font-weight="700" fill="#16225a">ENTER, RECOVER OR EXPLAIN</text>
8
- <text x="370" y="247" font-size="18" font-weight="400" fill="#334362">Project setup, task entry, interruption or requested learning</text>
9
- <g data-method="setup"><a href="../../methods/cyc-setup/SKILL.md" aria-label="Setup: Project needs configuration. Example: discover CI commands, run them and disclose hook status."><title>Example: discover CI commands, run them and disclose hook status.</title><rect x="370" y="268" width="385.5" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="384" y="296" font-size="23" font-weight="700" fill="#16225a">Setup</text><text x="384" y="326" font-size="16" font-weight="400" fill="#334362">Project needs configuration</text><text x="384" y="347" font-size="16" font-weight="400" fill="#334362">→ real checks + activation status</text></a></g>
10
- <g data-method="scout"><a href="../../methods/cyc-scout/SKILL.md" aria-label="Scout: Start a bounded engineering task. Example: locate the export path and the permission checks it must preserve."><title>Example: locate the export path and the permission checks it must preserve.</title><rect x="771.5" y="268" width="385.5" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="785.5" y="296" font-size="23" font-weight="700" fill="#16225a">Scout</text><text x="785.5" y="326" font-size="16" font-weight="400" fill="#334362">Start a bounded engineering task</text><text x="785.5" y="347" font-size="16" font-weight="400" fill="#334362">→ plan, consumers + checks</text></a></g>
11
- <g data-method="remember"><a href="../../methods/cyc-remember/SKILL.md" aria-label="Remember: Decision, checkpoint or resumption. Example: recover why a query was chosen; recheck files changed since the checkpoint."><title>Example: recover why a query was chosen; recheck files changed since the checkpoint.</title><rect x="1173" y="268" width="385.5" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="1187" y="296" font-size="23" font-weight="700" fill="#16225a">Remember</text><text x="1187" y="326" font-size="16" font-weight="400" fill="#334362">Decision, checkpoint or resumption</text><text x="1187" y="347" font-size="16" font-weight="400" fill="#334362">→ decision log + revalidated next step</text></a></g>
12
- <g data-method="teach"><a href="../../methods/cyc-teach/SKILL.md" aria-label="Teach: Engineer requests a lesson. Example: explain why visible page rows differ from all matching export records."><title>Example: explain why visible page rows differ from all matching export records.</title><rect x="1574.5" y="268" width="385.5" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="1588.5" y="296" font-size="23" font-weight="700" fill="#16225a">Teach</text><text x="1588.5" y="326" font-size="16" font-weight="400" fill="#334362">Engineer requests a lesson</text><text x="1588.5" y="347" font-size="16" font-weight="400" fill="#334362">→ project-grounded explanation / practice</text></a></g>
13
- <path d="M290 630 H320 V472 H350" fill="none" stroke="#2b69b0" stroke-width="2" marker-end="url(#select-arrow)"/>
14
- <rect x="350" y="445" width="1630" height="230" rx="12" fill="#f7f9fc" stroke="#ced9e5"/>
15
- <text x="370" y="474" font-size="21" font-weight="700" fill="#16225a">RESOLVE THE ENGINEERING QUESTION</text>
16
- <text x="370" y="502" font-size="18" font-weight="400" fill="#334362">Unclear goal, behavior, alternatives, impact, design or claim</text>
17
- <g data-method="frame"><a href="../../methods/cyc-frame/SKILL.md" aria-label="Frame: What counts as success?. Example: all matching rows, not merely a downloaded CSV."><title>Example: all matching rows, not merely a downloaded CSV.</title><rect x="370" y="523" width="251.66666666666666" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="384" y="551" font-size="23" font-weight="700" fill="#16225a">Frame</text><text x="384" y="581" font-size="16" font-weight="400" fill="#334362">What counts as success?</text><text x="384" y="602" font-size="16" font-weight="400" fill="#334362">→ criteria + scope</text></a></g>
18
- <g data-method="understand"><a href="../../methods/cyc-understand/SKILL.md" aria-label="Understand: Why does it behave this way?. Example: trace pagination from request to query."><title>Example: trace pagination from request to query.</title><rect x="637.6666666666666" y="523" width="251.66666666666666" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="651.6666666666666" y="551" font-size="23" font-weight="700" fill="#16225a">Understand</text><text x="651.6666666666666" y="581" font-size="16" font-weight="400" fill="#334362">Why does it behave this</text><text x="651.6666666666666" y="602" font-size="16" font-weight="400" fill="#334362">way?</text><text x="651.6666666666666" y="623" font-size="16" font-weight="400" fill="#334362">→ traced cause + evidence</text></a></g>
19
- <g data-method="explore"><a href="../../methods/cyc-explore/SKILL.md" aria-label="Explore: Which approach fits?. Example: compare paged fetch, streaming and queued export."><title>Example: compare paged fetch, streaming and queued export.</title><rect x="905.3333333333333" y="523" width="251.66666666666666" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="919.3333333333333" y="551" font-size="23" font-weight="700" fill="#16225a">Explore</text><text x="919.3333333333333" y="581" font-size="16" font-weight="400" fill="#334362">Which approach fits?</text><text x="919.3333333333333" y="602" font-size="16" font-weight="400" fill="#334362">→ compared options +</text><text x="919.3333333333333" y="623" font-size="16" font-weight="400" fill="#334362">recommendation</text></a></g>
20
- <g data-method="impact"><a href="../../methods/cyc-impact/SKILL.md" aria-label="Impact: What else could this affect?. Example: find permission and count consumers of the query."><title>Example: find permission and count consumers of the query.</title><rect x="1173" y="523" width="251.66666666666666" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="1187" y="551" font-size="23" font-weight="700" fill="#16225a">Impact</text><text x="1187" y="581" font-size="16" font-weight="400" fill="#334362">What else could this</text><text x="1187" y="602" font-size="16" font-weight="400" fill="#334362">affect?</text><text x="1187" y="623" font-size="16" font-weight="400" fill="#334362">→ dependencies + checks</text></a></g>
21
- <g data-method="design"><a href="../../methods/cyc-design/SKILL.md" aria-label="Design: How should the change work?. Example: define the export/query boundary and errors."><title>Example: define the export/query boundary and errors.</title><rect x="1440.6666666666665" y="523" width="251.66666666666666" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="1454.6666666666665" y="551" font-size="23" font-weight="700" fill="#16225a">Design</text><text x="1454.6666666666665" y="581" font-size="16" font-weight="400" fill="#334362">How should the change</text><text x="1454.6666666666665" y="602" font-size="16" font-weight="400" fill="#334362">work?</text><text x="1454.6666666666665" y="623" font-size="16" font-weight="400" fill="#334362">→ shape, contracts +</text><text x="1454.6666666666665" y="644" font-size="16" font-weight="400" fill="#334362">trade-offs</text></a></g>
22
- <g data-method="challenge"><a href="../../methods/cyc-challenge/SKILL.md" aria-label="Challenge: Does the plan or claim hold?. Example: question whether the export bypasses access filtering."><title>Example: question whether the export bypasses access filtering.</title><rect x="1708.333333333333" y="523" width="251.66666666666666" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="1722.333333333333" y="551" font-size="23" font-weight="700" fill="#16225a">Challenge</text><text x="1722.333333333333" y="581" font-size="16" font-weight="400" fill="#334362">Does the plan or claim</text><text x="1722.333333333333" y="602" font-size="16" font-weight="400" fill="#334362">hold?</text><text x="1722.333333333333" y="623" font-size="16" font-weight="400" fill="#334362">→ supported objections +</text><text x="1722.333333333333" y="644" font-size="16" font-weight="400" fill="#334362">resolution</text></a></g>
23
- <path d="M290 630 H320 V727 H350" fill="none" stroke="#2b69b0" stroke-width="2" marker-end="url(#select-arrow)"/>
24
- <rect x="350" y="700" width="1630" height="230" rx="12" fill="#f7f9fc" stroke="#ced9e5"/>
25
- <text x="370" y="729" font-size="21" font-weight="700" fill="#16225a">PRODUCE AND ESTABLISH THE RESULT</text>
26
- <text x="370" y="757" font-size="18" font-weight="400" fill="#334362">Implement, verify or hand off the selected task</text>
27
- <g data-method="build"><a href="../../methods/cyc-build/SKILL.md" aria-label="Build: An agreed approach needs implementation. Example: repair retrieval in small slices; check duplicates before continuing."><title>Example: repair retrieval in small slices; check duplicates before continuing.</title><rect x="370" y="778" width="519.3333333333334" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="384" y="806" font-size="23" font-weight="700" fill="#16225a">Build</text><text x="384" y="836" font-size="16" font-weight="400" fill="#334362">An agreed approach needs implementation</text><text x="384" y="857" font-size="16" font-weight="400" fill="#334362">→ tested slices + inspected changes</text></a></g>
28
- <g data-method="verify"><a href="../../methods/cyc-verify/SKILL.md" aria-label="Verify: A behavior claim needs current evidence. Example: inspect the full exported membership, permissions and CSV consumer."><title>Example: inspect the full exported membership, permissions and CSV consumer.</title><rect x="905.3333333333334" y="778" width="519.3333333333334" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="919.3333333333334" y="806" font-size="23" font-weight="700" fill="#16225a">Verify</text><text x="919.3333333333334" y="836" font-size="16" font-weight="400" fill="#334362">A behavior claim needs current evidence</text><text x="919.3333333333334" y="857" font-size="16" font-weight="400" fill="#334362">→ checks, consumer results + limits</text></a></g>
29
- <g data-method="deliver"><a href="../../methods/cyc-deliver/SKILL.md" aria-label="Deliver: The result needs a reviewable handoff. Example: explain the query change, show checks and identify unmeasured scale."><title>Example: explain the query change, show checks and identify unmeasured scale.</title><rect x="1440.6666666666667" y="778" width="519.3333333333334" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="1454.6666666666667" y="806" font-size="23" font-weight="700" fill="#16225a">Deliver</text><text x="1454.6666666666667" y="836" font-size="16" font-weight="400" fill="#334362">The result needs a reviewable handoff</text><text x="1454.6666666666667" y="857" font-size="16" font-weight="400" fill="#334362">→ outcome, evidence + remaining limits</text></a></g>
30
- <path d="M290 630 H320 V982 H350" fill="none" stroke="#2b69b0" stroke-width="2" marker-end="url(#select-arrow)"/>
31
- <rect x="350" y="955" width="1630" height="230" rx="12" fill="#f7f9fc" stroke="#ced9e5"/>
32
- <text x="370" y="984" font-size="21" font-weight="700" fill="#16225a">PRESERVE KNOWLEDGE AND RESPOND TO FINDINGS</text>
33
- <text x="370" y="1012" font-size="18" font-weight="400" fill="#334362">Relevant history, failed attempts, user correction or reusable lessons</text>
34
- <g data-method="context"><a href="../../methods/cyc-context/SKILL.md" aria-label="Context: Before component work; useful findings. Example: retain observed query constraints with evidence; identify adopted decisions only with actual acceptance."><title>Example: retain observed query constraints with evidence; identify adopted decisions only with actual acceptance.</title><rect x="370" y="1033" width="385.5" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="384" y="1061" font-size="23" font-weight="700" fill="#16225a">Context</text><text x="384" y="1091" font-size="16" font-weight="400" fill="#334362">Before component work; useful findings</text><text x="384" y="1112" font-size="16" font-weight="400" fill="#334362">→ verified facts / pending proposals</text></a></g>
35
- <g data-method="error-ledger"><a href="../../methods/cyc-error-ledger/SKILL.md" aria-label="Error Ledger: Before debugging; after failed attempts. Example: record that a paging fix duplicated rows and the check that exposed it."><title>Example: record that a paging fix duplicated rows and the check that exposed it.</title><rect x="771.5" y="1033" width="385.5" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="785.5" y="1061" font-size="23" font-weight="700" fill="#16225a">Error Ledger</text><text x="785.5" y="1091" font-size="16" font-weight="400" fill="#334362">Before debugging; after failed attempts</text><text x="785.5" y="1112" font-size="16" font-weight="400" fill="#334362">→ signatures, attempts + confirmed causes</text></a></g>
36
- <g data-method="correct"><a href="../../methods/cyc-correct/SKILL.md" aria-label="Correct: Feedback reveals a missing criterion. Example: “Not just the visible page” changes the target and its verification."><title>Example: “Not just the visible page” changes the target and its verification.</title><rect x="1173" y="1033" width="385.5" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="1187" y="1061" font-size="23" font-weight="700" fill="#16225a">Correct</text><text x="1187" y="1091" font-size="16" font-weight="400" fill="#334362">Feedback reveals a missing criterion</text><text x="1187" y="1112" font-size="16" font-weight="400" fill="#334362">→ targeted repair + rechecked criteria</text></a></g>
37
- <g data-method="reflect"><a href="../../methods/cyc-reflect/SKILL.md" aria-label="Reflect: An outcome reveals a reusable improvement. Example: propose a multi-page check after a repeated omission; do not silently adopt rules."><title>Example: propose a multi-page check after a repeated omission; do not silently adopt rules.</title><rect x="1574.5" y="1033" width="385.5" height="136" rx="8" fill="white" stroke="#2b69b0"/><text x="1588.5" y="1061" font-size="23" font-weight="700" fill="#16225a">Reflect</text><text x="1588.5" y="1091" font-size="16" font-weight="400" fill="#334362">An outcome reveals a reusable improvement</text><text x="1588.5" y="1112" font-size="16" font-weight="400" fill="#334362">→ evidence-backed proposals to</text><text x="1588.5" y="1133" font-size="16" font-weight="400" fill="#334362">skills/checks</text></a></g>
38
- <text x="40" y="1230" font-size="19" font-weight="400" fill="#334362">The playbook sets the recorded sequence; the agent selects methods and interprets their findings. The controller does not invoke skills.</text>
39
- <a href="cyc-workflow.html#overview"><text x="40" y="1264" font-size="21" font-weight="700" fill="#2b69b0">Continue to the connected implementation flow →</text></a></svg>
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="2020" height="1300" viewBox="0 0 2020 1300" role="img" aria-labelledby="methods-title methods-desc" font-family="Segoe UI, Arial, sans-serif"><style>.s0{fill:#eaf3ff;stroke:#2b69b0;stroke-width:2}.s1{fill:none;stroke:#2b69b0;stroke-width:2}.s2{fill:#f7f9fc;stroke:#ced9e5}.s3{fill:white;stroke:#2b69b0}</style><style>.t0{font-size:40px;font-weight:800;fill:#16225a}.t1{font-size:22px;fill:#334362}.t2{font-size:19px;fill:#334362}.t3{font-size:30px;font-weight:800;fill:#16225a}.t4{font-size:21px;font-weight:700;fill:#334362}.t5{font-size:18px;fill:#334362}.t6{font-size:21px;font-weight:700;fill:#16225a}.t7{font-size:23px;font-weight:700;fill:#16225a}.t8{font-size:16px;fill:#334362}.t9{font-size:21px;font-weight:700;fill:#2b69b0}</style><title id="methods-title">CYC complete method-selection map</title><desc id="methods-desc">The cyc orchestrator chooses methods by task need. All seventeen supporting methods have a selection condition and output. These are capabilities, not seventeen mandatory steps. Examples are available in each method's accessible description; links open its source instructions.</desc><defs><marker id="select-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto"><path d="M0 0 L10 5 L0 10 Z" fill="#2b69b0"/></marker></defs><rect width="2020" height="1300" fill="white"/><text x="40" y="54" class="t0">CYC · the full method library</text><text x="40" y="96" class="t1">1 orchestrator selects from 17 methods and 15 playbooks. Four stages describe only the common implementation route.</text><text x="40" y="134" class="t2">Arrows show selection by need. Rows group responsibilities; they are not an execution sequence. Click a method to read its instructions.</text><g data-method="cyc"><a href="../../skills/cyc/SKILL.md"><rect x="40" y="540" width="250" height="180" rx="12" class="s0"/><text x="60" y="578" class="t3">/cyc</text><text x="60" y="616" class="t4">Own the outcome</text><text x="60" y="650" class="t5">Choose the playbook</text><text x="60" y="681" class="t5">Load relevant methods</text></a></g><path d="M290 630 H320 V217 H350" marker-end="url(#select-arrow)" class="s1"/><rect x="350" y="190" width="1630" height="230" rx="12" class="s2"/><text x="370" y="219" class="t6">ENTER, RECOVER OR EXPLAIN</text><text x="370" y="247" class="t5">Project setup, task entry, interruption or requested learning</text><g data-method="setup"><a href="../../methods/cyc-setup/SKILL.md" aria-label="Setup: Project needs configuration. Example: discover CI commands, run them and disclose hook status."><title>Example: discover CI commands, run them and disclose hook status.</title><rect x="370" y="268" width="385.5" height="136" rx="8" class="s3"/><text x="384" y="296" class="t7">Setup</text><text x="384" y="326" class="t8">Project needs configuration</text><text x="384" y="347" class="t8">→ real checks + activation status</text></a></g><g data-method="scout"><a href="../../methods/cyc-scout/SKILL.md" aria-label="Scout: Start a bounded engineering task. Example: locate the export path and the permission checks it must preserve."><title>Example: locate the export path and the permission checks it must preserve.</title><rect x="771.5" y="268" width="385.5" height="136" rx="8" class="s3"/><text x="785.5" y="296" class="t7">Scout</text><text x="785.5" y="326" class="t8">Start a bounded engineering task</text><text x="785.5" y="347" class="t8">→ plan, consumers + checks</text></a></g><g data-method="remember"><a href="../../methods/cyc-remember/SKILL.md" aria-label="Remember: Decision, checkpoint or resumption. Example: recover why a query was chosen; recheck files changed since the checkpoint."><title>Example: recover why a query was chosen; recheck files changed since the checkpoint.</title><rect x="1173" y="268" width="385.5" height="136" rx="8" class="s3"/><text x="1187" y="296" class="t7">Remember</text><text x="1187" y="326" class="t8">Decision, checkpoint or resumption</text><text x="1187" y="347" class="t8">→ decision log + revalidated next step</text></a></g><g data-method="teach"><a href="../../methods/cyc-teach/SKILL.md" aria-label="Teach: Engineer requests a lesson. Example: explain why visible page rows differ from all matching export records."><title>Example: explain why visible page rows differ from all matching export records.</title><rect x="1574.5" y="268" width="385.5" height="136" rx="8" class="s3"/><text x="1588.5" y="296" class="t7">Teach</text><text x="1588.5" y="326" class="t8">Engineer requests a lesson</text><text x="1588.5" y="347" class="t8">→ project-grounded explanation / practice</text></a></g><path d="M290 630 H320 V472 H350" marker-end="url(#select-arrow)" class="s1"/><rect x="350" y="445" width="1630" height="230" rx="12" class="s2"/><text x="370" y="474" class="t6">RESOLVE THE ENGINEERING QUESTION</text><text x="370" y="502" class="t5">Unclear goal, behavior, alternatives, impact, design or claim</text><g data-method="frame"><a href="../../methods/cyc-frame/SKILL.md" aria-label="Frame: What counts as success?. Example: all matching rows, not merely a downloaded CSV."><title>Example: all matching rows, not merely a downloaded CSV.</title><rect x="370" y="523" width="251.66666666666666" height="136" rx="8" class="s3"/><text x="384" y="551" class="t7">Frame</text><text x="384" y="581" class="t8">What counts as success?</text><text x="384" y="602" class="t8">→ criteria + scope</text></a></g><g data-method="understand"><a href="../../methods/cyc-understand/SKILL.md" aria-label="Understand: Why does it behave this way?. Example: trace pagination from request to query."><title>Example: trace pagination from request to query.</title><rect x="637.6666666666666" y="523" width="251.66666666666666" height="136" rx="8" class="s3"/><text x="651.6666666666666" y="551" class="t7">Understand</text><text x="651.6666666666666" y="581" class="t8">Why does it behave this</text><text x="651.6666666666666" y="602" class="t8">way?</text><text x="651.6666666666666" y="623" class="t8">→ traced cause + evidence</text></a></g><g data-method="explore"><a href="../../methods/cyc-explore/SKILL.md" aria-label="Explore: Which approach fits?. Example: compare paged fetch, streaming and queued export."><title>Example: compare paged fetch, streaming and queued export.</title><rect x="905.3333333333333" y="523" width="251.66666666666666" height="136" rx="8" class="s3"/><text x="919.3333333333333" y="551" class="t7">Explore</text><text x="919.3333333333333" y="581" class="t8">Which approach fits?</text><text x="919.3333333333333" y="602" class="t8">→ compared options +</text><text x="919.3333333333333" y="623" class="t8">recommendation</text></a></g><g data-method="impact"><a href="../../methods/cyc-impact/SKILL.md" aria-label="Impact: What else could this affect?. Example: find permission and count consumers of the query."><title>Example: find permission and count consumers of the query.</title><rect x="1173" y="523" width="251.66666666666666" height="136" rx="8" class="s3"/><text x="1187" y="551" class="t7">Impact</text><text x="1187" y="581" class="t8">What else could this</text><text x="1187" y="602" class="t8">affect?</text><text x="1187" y="623" class="t8">→ dependencies + checks</text></a></g><g data-method="design"><a href="../../methods/cyc-design/SKILL.md" aria-label="Design: How should the change work?. Example: define the export/query boundary and errors."><title>Example: define the export/query boundary and errors.</title><rect x="1440.6666666666665" y="523" width="251.66666666666666" height="136" rx="8" class="s3"/><text x="1454.6666666666665" y="551" class="t7">Design</text><text x="1454.6666666666665" y="581" class="t8">How should the change</text><text x="1454.6666666666665" y="602" class="t8">work?</text><text x="1454.6666666666665" y="623" class="t8">→ shape, contracts +</text><text x="1454.6666666666665" y="644" class="t8">trade-offs</text></a></g><g data-method="challenge"><a href="../../methods/cyc-challenge/SKILL.md" aria-label="Challenge: Does the plan or claim hold?. Example: question whether the export bypasses access filtering."><title>Example: question whether the export bypasses access filtering.</title><rect x="1708.333333333333" y="523" width="251.66666666666666" height="136" rx="8" class="s3"/><text x="1722.333333333333" y="551" class="t7">Challenge</text><text x="1722.333333333333" y="581" class="t8">Does the plan or claim</text><text x="1722.333333333333" y="602" class="t8">hold?</text><text x="1722.333333333333" y="623" class="t8">→ supported objections +</text><text x="1722.333333333333" y="644" class="t8">resolution</text></a></g><path d="M290 630 H320 V727 H350" marker-end="url(#select-arrow)" class="s1"/><rect x="350" y="700" width="1630" height="230" rx="12" class="s2"/><text x="370" y="729" class="t6">PRODUCE AND ESTABLISH THE RESULT</text><text x="370" y="757" class="t5">Implement, verify or hand off the selected task</text><g data-method="build"><a href="../../methods/cyc-build/SKILL.md" aria-label="Build: An agreed approach needs implementation. Example: repair retrieval in small slices; check duplicates before continuing."><title>Example: repair retrieval in small slices; check duplicates before continuing.</title><rect x="370" y="778" width="519.3333333333334" height="136" rx="8" class="s3"/><text x="384" y="806" class="t7">Build</text><text x="384" y="836" class="t8">An agreed approach needs implementation</text><text x="384" y="857" class="t8">→ tested slices + inspected changes</text></a></g><g data-method="verify"><a href="../../methods/cyc-verify/SKILL.md" aria-label="Verify: A behavior claim needs current evidence. Example: inspect the full exported membership, permissions and CSV consumer."><title>Example: inspect the full exported membership, permissions and CSV consumer.</title><rect x="905.3333333333334" y="778" width="519.3333333333334" height="136" rx="8" class="s3"/><text x="919.3333333333334" y="806" class="t7">Verify</text><text x="919.3333333333334" y="836" class="t8">A behavior claim needs current evidence</text><text x="919.3333333333334" y="857" class="t8">→ checks, consumer results + limits</text></a></g><g data-method="deliver"><a href="../../methods/cyc-deliver/SKILL.md" aria-label="Deliver: The result needs a reviewable handoff. Example: explain the query change, show checks and identify unmeasured scale."><title>Example: explain the query change, show checks and identify unmeasured scale.</title><rect x="1440.6666666666667" y="778" width="519.3333333333334" height="136" rx="8" class="s3"/><text x="1454.6666666666667" y="806" class="t7">Deliver</text><text x="1454.6666666666667" y="836" class="t8">The result needs a reviewable handoff</text><text x="1454.6666666666667" y="857" class="t8">→ outcome, evidence + remaining limits</text></a></g><path d="M290 630 H320 V982 H350" marker-end="url(#select-arrow)" class="s1"/><rect x="350" y="955" width="1630" height="230" rx="12" class="s2"/><text x="370" y="984" class="t6">PRESERVE KNOWLEDGE AND RESPOND TO FINDINGS</text><text x="370" y="1012" class="t5">Relevant history, failed attempts, user correction or reusable lessons</text><g data-method="context"><a href="../../methods/cyc-context/SKILL.md" aria-label="Context: Before component work; useful findings. Example: retain observed query constraints with evidence; identify adopted decisions only with actual acceptance."><title>Example: retain observed query constraints with evidence; identify adopted decisions only with actual acceptance.</title><rect x="370" y="1033" width="385.5" height="136" rx="8" class="s3"/><text x="384" y="1061" class="t7">Context</text><text x="384" y="1091" class="t8">Before component work; useful findings</text><text x="384" y="1112" class="t8">→ verified facts / pending proposals</text></a></g><g data-method="error-ledger"><a href="../../methods/cyc-error-ledger/SKILL.md" aria-label="Error Ledger: Before debugging; after failed attempts. Example: record that a paging fix duplicated rows and the check that exposed it."><title>Example: record that a paging fix duplicated rows and the check that exposed it.</title><rect x="771.5" y="1033" width="385.5" height="136" rx="8" class="s3"/><text x="785.5" y="1061" class="t7">Error Ledger</text><text x="785.5" y="1091" class="t8">Before debugging; after failed attempts</text><text x="785.5" y="1112" class="t8">→ signatures, attempts + confirmed causes</text></a></g><g data-method="correct"><a href="../../methods/cyc-correct/SKILL.md" aria-label="Correct: Feedback reveals a missing criterion. Example: “Not just the visible page” changes the target and its verification."><title>Example: “Not just the visible page” changes the target and its verification.</title><rect x="1173" y="1033" width="385.5" height="136" rx="8" class="s3"/><text x="1187" y="1061" class="t7">Correct</text><text x="1187" y="1091" class="t8">Feedback reveals a missing criterion</text><text x="1187" y="1112" class="t8">→ targeted repair + rechecked criteria</text></a></g><g data-method="reflect"><a href="../../methods/cyc-reflect/SKILL.md" aria-label="Reflect: An outcome reveals a reusable improvement. Example: propose a multi-page check after a repeated omission; do not silently adopt rules."><title>Example: propose a multi-page check after a repeated omission; do not silently adopt rules.</title><rect x="1574.5" y="1033" width="385.5" height="136" rx="8" class="s3"/><text x="1588.5" y="1061" class="t7">Reflect</text><text x="1588.5" y="1091" class="t8">An outcome reveals a reusable improvement</text><text x="1588.5" y="1112" class="t8">→ evidence-backed proposals to</text><text x="1588.5" y="1133" class="t8">skills/checks</text></a></g><text x="40" y="1230" class="t2">The playbook sets the recorded sequence; the agent selects methods and interprets their findings. The controller does not invoke skills.</text><a href="cyc-workflow.html#overview"><text x="40" y="1264" class="t9">Continue to the connected implementation flow →</text></a></svg>
@@ -1,44 +1 @@
1
- <svg xmlns="http://www.w3.org/2000/svg" width="1200" height="1030" viewBox="0 0 1200 1030" role="img" aria-labelledby="overview-title overview-desc" font-family="Segoe UI, Arial, sans-serif"><title id="overview-title">CYC Stack team workflow</title><desc id="overview-desc">Your AI assistant reuses and revalidates project knowledge, builds a focused change and retains useful findings before final checks, proves applicable tests against original code, runs configured checks and reviews consumers, then delivers evidence and context pointers. The local controller checks records and executes project commands; an active host hook enforces delivery. Failed checks return to repair within the retry budget. Teams share through their existing project review process; run logs are local by default.</desc><defs><marker id="overview-forward" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto"><path d="M0 0 L10 5 L0 10 Z" fill="#197f70"/></marker><marker id="overview-knowledge" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto"><path d="M0 0 L10 5 L0 10 Z" fill="#7044b4"/></marker><marker id="overview-retry" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto"><path d="M0 0 L10 5 L0 10 Z" fill="#b86b0a"/></marker></defs><rect x="0" y="0" width="1200" height="1030" rx="14" fill="white" stroke="none" stroke-width="2"/>
2
- <text x="48" y="43" fill="#197f70" font-size="16" font-weight="700" text-anchor="start"><tspan x="48" dy="0">CYC STACK / TEAM WORKFLOW</tspan></text>
3
- <text x="48" y="88" fill="#16225a" font-size="35" font-weight="800" text-anchor="start"><tspan x="48" dy="0">Shared project knowledge. Reviewable AI changes.</tspan></text>
4
- <rect x="48" y="116" width="1104" height="60" rx="14" fill="#eaf3ff" stroke="#2b69b0" stroke-width="2"/>
5
- <text x="72" y="154" fill="#16225a" font-size="23" font-weight="600" text-anchor="start"><tspan x="72" dy="0">Describe the outcome. Your AI assistant selects the relevant methods through /cyc.</tspan></text>
6
- <rect x="48" y="202" width="1104" height="132" rx="14" fill="#f5effc" stroke="#7044b4" stroke-width="2"/>
7
- <text x="72" y="235" fill="#7044b4" font-size="16" font-weight="700" text-anchor="start"><tspan x="72" dy="0">PROJECT KNOWLEDGE IN YOUR REPO</tspan></text>
8
- <text x="72" y="268" fill="#16225a" font-size="23" font-weight="600" text-anchor="start"><tspan x="72" dy="0">Reuse matched decisions, constraints, failed approaches and check recipes.</tspan></text>
9
- <text x="72" y="300" fill="#334362" font-size="20" font-weight="400" text-anchor="start"><tspan x="72" dy="0">Revalidate current code. Keep useful verified facts; label proposals and record acceptance for adopted decisions.</tspan></text>
10
- <polyline points="174,334 174,400" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-knowledge)"/>
11
- <text x="196" y="373" fill="#7044b4" font-size="17" font-weight="600" text-anchor="start"><tspan x="196" dy="0">Read + revalidate</tspan></text>
12
- <polyline points="458,400 458,334" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-knowledge)"/>
13
- <text x="478" y="373" fill="#7044b4" font-size="17" font-weight="600" text-anchor="start"><tspan x="478" dy="0">Retain before final checks</tspan></text>
14
- <rect x="48" y="400" width="252" height="200" rx="14" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
15
- <text x="68" y="439" fill="#16225a" font-size="27" font-weight="800" text-anchor="start"><tspan x="68" dy="0">1. SCOUT</tspan></text>
16
- <text x="68" y="471" fill="#197f70" font-size="18" font-weight="600" text-anchor="start"><tspan x="68" dy="0">Understand the change</tspan></text>
17
- <text x="68" y="514" fill="#334362" font-size="20" font-weight="400" text-anchor="start"><tspan x="68" dy="0">Read relevant history.</tspan><tspan x="68" dy="29">Trace affected paths.</tspan><tspan x="68" dy="29">Set criteria and checks.</tspan></text>
18
- <polyline points="300,500 332,500" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-forward)"/>
19
- <rect x="332" y="400" width="252" height="200" rx="14" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
20
- <text x="352" y="439" fill="#16225a" font-size="27" font-weight="800" text-anchor="start"><tspan x="352" dy="0">2. BUILD</tspan></text>
21
- <text x="352" y="471" fill="#197f70" font-size="18" font-weight="600" text-anchor="start"><tspan x="352" dy="0">Make a focused change</tspan></text>
22
- <text x="352" y="514" fill="#334362" font-size="20" font-weight="400" text-anchor="start"><tspan x="352" dy="0">Change one useful slice.</tspan><tspan x="352" dy="29">Check affected behavior.</tspan><tspan x="352" dy="29">Retain useful findings.</tspan></text>
23
- <polyline points="584,500 616,500" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-forward)"/>
24
- <rect x="616" y="400" width="252" height="200" rx="14" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
25
- <text x="636" y="439" fill="#16225a" font-size="27" font-weight="800" text-anchor="start"><tspan x="636" dy="0">3. VERIFY</tspan></text>
26
- <text x="636" y="471" fill="#197f70" font-size="18" font-weight="600" text-anchor="start"><tspan x="636" dy="0">Establish current evidence</tspan></text>
27
- <text x="636" y="514" fill="#334362" font-size="20" font-weight="400" text-anchor="start"><tspan x="636" dy="0">Original-code proof.*</tspan><tspan x="636" dy="29">Your configured checks.</tspan><tspan x="636" dy="29">Intent + consumer review.</tspan></text>
28
- <polyline points="868,500 900,500" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-forward)"/>
29
- <rect x="900" y="400" width="252" height="200" rx="14" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
30
- <text x="920" y="439" fill="#16225a" font-size="27" font-weight="800" text-anchor="start"><tspan x="920" dy="0">4. DELIVER</tspan></text>
31
- <text x="920" y="471" fill="#197f70" font-size="18" font-weight="600" text-anchor="start"><tspan x="920" dy="0">Leave a useful handoff</tspan></text>
32
- <text x="920" y="514" fill="#334362" font-size="20" font-weight="400" text-anchor="start"><tspan x="920" dy="0">Outcome and limits.</tspan><tspan x="920" dy="29">A generated review.</tspan><tspan x="920" dy="29">Useful context pointers.</tspan></text>
33
- <polyline points="742,600 742,665 458,665 458,600" fill="none" stroke="#b86b0a" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-retry)"/>
34
- <text x="600" y="696" fill="#b86b0a" font-size="19" font-weight="600" text-anchor="middle"><tspan x="600" dy="0">Failed checks return to repair within the same retry budget.</tspan></text>
35
- <text x="48" y="740" fill="#16225a" font-size="22" font-weight="700" text-anchor="start"><tspan x="48" dy="0">The assistant does the engineering. Code checks the recorded evidence.</tspan></text>
36
- <rect x="48" y="765" width="536" height="128" rx="14" fill="#f3f6fa" stroke="#ced9e5" stroke-width="2"/>
37
- <text x="72" y="800" fill="#16225a" font-size="23" font-weight="700" text-anchor="start"><tspan x="72" dy="0">LOCAL CONTROLLER</tspan></text>
38
- <text x="72" y="833" fill="#334362" font-size="19" font-weight="400" text-anchor="start"><tspan x="72" dy="0">Scope, current file evidence and retry budgets.</tspan><tspan x="72" dy="29">Runs the project’s configured commands.</tspan></text>
39
- <rect x="616" y="765" width="536" height="128" rx="14" fill="#eaf3ff" stroke="#2b69b0" stroke-width="2"/>
40
- <text x="640" y="800" fill="#16225a" font-size="23" font-weight="700" text-anchor="start"><tspan x="640" dy="0">ACTIVE HOST HOOK</tspan></text>
41
- <text x="640" y="833" fill="#334362" font-size="19" font-weight="400" text-anchor="start"><tspan x="640" dy="0">Enforces delivery when the hook is active.</tspan><tspan x="640" dy="29">A ready result or an honest blocked handoff.</tspan></text>
42
- <text x="48" y="927" fill="#334362" font-size="17" font-weight="400" text-anchor="start"><tspan x="48" dy="0">* Original-code proof for applicable feature, bug-fix and refactor runs; exemptions are recorded.</tspan></text>
43
- <text x="48" y="964" fill="#16225a" font-size="22" font-weight="700" text-anchor="start"><tspan x="48" dy="0">Your team reviews and shares. Publication requires authorization.</tspan></text>
44
- <text x="48" y="995" fill="#334362" font-size="18" font-weight="400" text-anchor="start"><tspan x="48" dy="0">Run logs stay local by default. Share useful project docs and review evidence through your normal process.</tspan></text></svg>
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="1200" height="1030" viewBox="0 0 1200 1030" role="img" aria-labelledby="overview-title overview-desc" font-family="Segoe UI, Arial, sans-serif"><style>.s0{fill:white;stroke:none;stroke-width:2}.s1{fill:#eaf3ff;stroke:#2b69b0;stroke-width:2}.s2{fill:#f5effc;stroke:#7044b4;stroke-width:2}.s3{fill:#e6f5ef;stroke:#197f70;stroke-width:2}.s4{fill:#f3f6fa;stroke:#ced9e5;stroke-width:2}</style><style>.t0{fill:#197f70;font-size:16px;font-weight:700}.t1{fill:#16225a;font-size:35px;font-weight:800}.t2{fill:#16225a;font-size:23px;font-weight:600}.t3{fill:#7044b4;font-size:16px;font-weight:700}.t4{fill:#334362;font-size:20px}.t5{fill:#7044b4;font-size:17px;font-weight:600}.t6{fill:#16225a;font-size:27px;font-weight:800}.t7{fill:#197f70;font-size:18px;font-weight:600}.t8{fill:#b86b0a;font-size:19px;font-weight:600;text-anchor:middle}.t9{fill:#16225a;font-size:22px;font-weight:700}.t10{fill:#16225a;font-size:23px;font-weight:700}.t11{fill:#334362;font-size:19px}.t12{fill:#334362;font-size:17px}.t13{fill:#334362;font-size:18px}</style><title id="overview-title">CYC Stack team workflow</title><desc id="overview-desc">Your AI assistant reuses and revalidates project knowledge, builds a focused change and retains useful findings before final checks, proves applicable tests against original code, runs configured checks and reviews consumers, then delivers evidence and context pointers. The local controller checks records and executes project commands; an active host hook enforces delivery. Failed checks return to repair within the retry budget. Teams share through their existing project review process; run logs are local by default.</desc><defs><marker id="overview-forward" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto"><path d="M0 0 L10 5 L0 10 Z" fill="#197f70"/></marker><marker id="overview-knowledge" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto"><path d="M0 0 L10 5 L0 10 Z" fill="#7044b4"/></marker><marker id="overview-retry" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto"><path d="M0 0 L10 5 L0 10 Z" fill="#b86b0a"/></marker></defs><rect x="0" y="0" width="1200" height="1030" rx="14" class="s0"/><text x="48" y="43" class="t0">CYC STACK / TEAM WORKFLOW</text><text x="48" y="88" class="t1">Shared project knowledge. Reviewable AI changes.</text><rect x="48" y="116" width="1104" height="60" rx="14" class="s1"/><text x="72" y="154" class="t2">Describe the outcome. Your AI assistant selects the relevant methods through /cyc.</text><rect x="48" y="202" width="1104" height="132" rx="14" class="s2"/><text x="72" y="235" class="t3">PROJECT KNOWLEDGE IN YOUR REPO</text><text x="72" y="268" class="t2">Reuse matched decisions, constraints, failed approaches and check recipes.</text><text x="72" y="300" class="t4">Revalidate current code. Keep useful verified facts; label proposals and record acceptance for adopted decisions.</text><polyline points="174,334 174,400" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-knowledge)"/><text x="196" y="373" class="t5">Read + revalidate</text><polyline points="458,400 458,334" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-knowledge)"/><text x="478" y="373" class="t5">Retain before final checks</text><rect x="48" y="400" width="252" height="200" rx="14" class="s3"/><text x="68" y="439" class="t6">1. SCOUT</text><text x="68" y="471" class="t7">Understand the change</text><text x="68" y="514" class="t4">Read relevant history.<tspan x="68" dy="29">Trace affected paths.</tspan><tspan x="68" dy="29">Set criteria and checks.</tspan></text><polyline points="300,500 332,500" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-forward)"/><rect x="332" y="400" width="252" height="200" rx="14" class="s3"/><text x="352" y="439" class="t6">2. BUILD</text><text x="352" y="471" class="t7">Make a focused change</text><text x="352" y="514" class="t4">Change one useful slice.<tspan x="352" dy="29">Check affected behavior.</tspan><tspan x="352" dy="29">Retain useful findings.</tspan></text><polyline points="584,500 616,500" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-forward)"/><rect x="616" y="400" width="252" height="200" rx="14" class="s3"/><text x="636" y="439" class="t6">3. VERIFY</text><text x="636" y="471" class="t7">Establish current evidence</text><text x="636" y="514" class="t4">Original-code proof.*<tspan x="636" dy="29">Your configured checks.</tspan><tspan x="636" dy="29">Intent + consumer review.</tspan></text><polyline points="868,500 900,500" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-forward)"/><rect x="900" y="400" width="252" height="200" rx="14" class="s3"/><text x="920" y="439" class="t6">4. DELIVER</text><text x="920" y="471" class="t7">Leave a useful handoff</text><text x="920" y="514" class="t4">Outcome and limits.<tspan x="920" dy="29">A generated review.</tspan><tspan x="920" dy="29">Useful context pointers.</tspan></text><polyline points="742,600 742,665 458,665 458,600" fill="none" stroke="#b86b0a" stroke-width="3" stroke-linejoin="round" marker-end="url(#overview-retry)"/><text x="600" y="696" class="t8">Failed checks return to repair within the same retry budget.</text><text x="48" y="740" class="t9">The assistant does the engineering. Code checks the recorded evidence.</text><rect x="48" y="765" width="536" height="128" rx="14" class="s4"/><text x="72" y="800" class="t10">LOCAL CONTROLLER</text><text x="72" y="833" class="t11">Scope, current file evidence and retry budgets.<tspan x="72" dy="29">Runs the project’s configured commands.</tspan></text><rect x="616" y="765" width="536" height="128" rx="14" class="s1"/><text x="640" y="800" class="t10">ACTIVE HOST HOOK</text><text x="640" y="833" class="t11">Enforces delivery when the hook is active.<tspan x="640" dy="29">A ready result or an honest blocked handoff.</tspan></text><text x="48" y="927" class="t12">* Original-code proof for applicable feature, bug-fix and refactor runs; exemptions are recorded.</text><text x="48" y="964" class="t9">Your team reviews and shares. Publication requires authorization.</text><text x="48" y="995" class="t13">Run logs stay local by default. Share useful project docs and review evidence through your normal process.</text></svg>