cyc-stack 0.0.0-stage → 0.7.0
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.
- package/.agents/plugins/marketplace.json +12 -0
- package/.claude-plugin/marketplace.json +14 -0
- package/.claude-plugin/plugin.json +17 -0
- package/.codex-plugin/plugin.json +33 -0
- package/.cursor-plugin/marketplace.json +13 -0
- package/.cursor-plugin/plugin.json +19 -0
- package/INSTALL.md +153 -0
- package/LICENSE +21 -0
- package/README.md +436 -2
- package/bin/cyc.mjs +294 -0
- package/catalog/playbooks.json +20 -0
- package/docs/README.md +30 -0
- package/docs/assets/cyc-method-library.svg +39 -0
- package/docs/assets/cyc-overview.svg +44 -0
- package/docs/assets/cyc-readme-banner-mobile.svg +31 -0
- package/docs/assets/cyc-readme-banner.svg +39 -0
- package/docs/assets/cyc-workflow-diagram.svg +415 -0
- package/docs/code-quality.md +42 -0
- package/docs/context.md +40 -0
- package/docs/cyc-method-map.md +58 -0
- package/docs/cyc-workflow.md +188 -0
- package/docs/engineering/code-standards.md +103 -0
- package/docs/engineering/domain-design.md +81 -0
- package/docs/engineering/failure-handling.md +105 -0
- package/docs/impact-analysis.md +70 -0
- package/docs/installation.md +198 -0
- package/docs/onboarding-recovery.md +75 -0
- package/docs/principles.md +49 -0
- package/docs/project-tools.md +108 -0
- package/docs/response-standard.md +202 -0
- package/docs/runtime.md +249 -0
- package/docs/skill-contract.md +70 -0
- package/docs/skill-craft.md +23 -0
- package/docs/validation.md +39 -0
- package/docs/work-assessments.md +180 -0
- package/hooks/claude.json +10 -0
- package/hooks/codex.json +28 -0
- package/hooks/cursor.json +8 -0
- package/methods/cyc-build/SKILL.md +65 -0
- package/methods/cyc-build/references/file-writes.md +11 -0
- package/methods/cyc-challenge/SKILL.md +48 -0
- package/methods/cyc-context/SKILL.md +76 -0
- package/methods/cyc-context/references/evidence.md +27 -0
- package/methods/cyc-context/references/templates.md +54 -0
- package/methods/cyc-context/scripts/evidence.mjs +61 -0
- package/methods/cyc-correct/SKILL.md +43 -0
- package/methods/cyc-deliver/SKILL.md +52 -0
- package/methods/cyc-design/SKILL.md +50 -0
- package/methods/cyc-design/frontend-design/SKILL.md +43 -0
- package/methods/cyc-design/frontend-design/references/color.md +77 -0
- package/methods/cyc-design/frontend-design/references/craft-rules.md +61 -0
- package/methods/cyc-design/frontend-design/references/decision-sheet.md +110 -0
- package/methods/cyc-design/frontend-design/references/experience-review.md +58 -0
- package/methods/cyc-design/frontend-design/references/generic-tells.md +76 -0
- package/methods/cyc-design/frontend-design/references/layout-archetypes.md +188 -0
- package/methods/cyc-design/frontend-design/references/reference-standards.md +38 -0
- package/methods/cyc-design/frontend-design/references/typography.md +51 -0
- package/methods/cyc-design/frontend-design/references/ux-foundations.md +45 -0
- package/methods/cyc-design/frontend-design/references/visual-material.md +42 -0
- package/methods/cyc-error-ledger/SKILL.md +53 -0
- package/methods/cyc-error-ledger/references/entry-format.md +38 -0
- package/methods/cyc-explore/SKILL.md +41 -0
- package/methods/cyc-frame/SKILL.md +49 -0
- package/methods/cyc-impact/SKILL.md +64 -0
- package/methods/cyc-reflect/SKILL.md +48 -0
- package/methods/cyc-remember/SKILL.md +53 -0
- package/methods/cyc-scout/SKILL.md +67 -0
- package/methods/cyc-setup/SKILL.md +60 -0
- package/methods/cyc-teach/SKILL.md +40 -0
- package/methods/cyc-understand/SKILL.md +40 -0
- package/methods/cyc-understand/references/diagnose.md +53 -0
- package/methods/cyc-verify/SKILL.md +87 -0
- package/methods/cyc-verify/references/recipe.md +53 -0
- package/package.json +91 -4
- package/plugin.json +40 -0
- package/rules/cyc-delivery.mdc +33 -0
- package/scripts/baseline-worker.mjs +10 -0
- package/scripts/catalog.mjs +29 -0
- package/scripts/claude-project-hook.mjs +12 -0
- package/scripts/context-review.mjs +600 -0
- package/scripts/host-activation.mjs +66 -0
- package/scripts/install.mjs +387 -0
- package/scripts/onboarding.mjs +110 -0
- package/scripts/packet.mjs +107 -0
- package/scripts/project-tools.mjs +196 -0
- package/scripts/recovery.mjs +66 -0
- package/scripts/response-gate.mjs +105 -0
- package/scripts/response-hook.mjs +237 -0
- package/scripts/response-mode.mjs +12 -0
- package/scripts/run-gate.mjs +264 -0
- package/scripts/runtime.mjs +1832 -0
- package/scripts/source-hash-worker.mjs +5 -0
- package/scripts/source-snapshot.mjs +405 -0
- package/scripts/test-output.mjs +268 -0
- package/scripts/work-review.mjs +326 -0
- package/skills/cyc/SKILL.md +132 -0
- package/skills/cyc/references/playbooks/bug-fix.md +13 -0
- package/skills/cyc/references/playbooks/evaluate.md +13 -0
- package/skills/cyc/references/playbooks/experience.md +7 -0
- package/skills/cyc/references/playbooks/explore.md +9 -0
- package/skills/cyc/references/playbooks/feature.md +14 -0
- package/skills/cyc/references/playbooks/handoff.md +11 -0
- package/skills/cyc/references/playbooks/investigation.md +7 -0
- package/skills/cyc/references/playbooks/performance.md +7 -0
- package/skills/cyc/references/playbooks/plan.md +11 -0
- package/skills/cyc/references/playbooks/refactor.md +12 -0
- package/skills/cyc/references/playbooks/reflect.md +11 -0
- package/skills/cyc/references/playbooks/resume.md +11 -0
- package/skills/cyc/references/playbooks/review.md +9 -0
- package/skills/cyc/references/playbooks/teach.md +11 -0
- package/skills/cyc/references/playbooks/verify.md +7 -0
package/bin/cyc.mjs
ADDED
|
@@ -0,0 +1,294 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
3
|
+
import { dirname, resolve } from 'node:path';
|
|
4
|
+
import { isDeepStrictEqual } from 'node:util';
|
|
5
|
+
import { catalog, routeTask } from '../scripts/catalog.mjs';
|
|
6
|
+
import { acceptFailure, activeRun, callerSession, inputPath, completeRun, controlRun, finishRun, nextRun, projectFile, proveRun, quickHandoff, readRun, recordHandoff, recoverRun, retryRun, reviewRun, startRun, verifyRun, captureReview, recordReview } from '../scripts/runtime.mjs';
|
|
7
|
+
|
|
8
|
+
const args = process.argv.slice(2);
|
|
9
|
+
const positionals = [];
|
|
10
|
+
const options = {};
|
|
11
|
+
const flags = new Set(['dry-run', 'help', 'verbose', 'verify', 'reviewed', 'write', 'all', 'expanded']);
|
|
12
|
+
try {
|
|
13
|
+
for (let i = 0; i < args.length; i++) {
|
|
14
|
+
if (!args[i].startsWith('--')) { positionals.push(args[i]); continue; }
|
|
15
|
+
const name = args[i].slice(2);
|
|
16
|
+
if (flags.has(name)) { options[name] = true; continue; }
|
|
17
|
+
if (!['project', 'hosts', 'host', 'token', 'goal', 'playbook', 'criteria', 'run', 'file', 'scope', 'stage', 'reason', 'session', 'since', 'check', 'status', 'summary', 'artifact', 'criteria-passed', 'criterion-evidence', 'next', 'criterion', 'verbose', 'assessment', 'response', 'blocker', 'advisory', 'passed', 'unmet', 'tests', 'path', 'limit', 'recipe', 'kind', 'plan', 'scout', 'new', 'doc'].includes(name)) throw new Error(`Unknown option --${name}`);
|
|
18
|
+
const value = args[++i];
|
|
19
|
+
if (!value || value.startsWith('--')) throw new Error(`--${name} needs a value.`);
|
|
20
|
+
if (['scope', 'artifact', 'criterion', 'passed', 'unmet', 'tests', 'path'].includes(name)) {
|
|
21
|
+
(options[name] ??= []).push(value);
|
|
22
|
+
// Lists take every following value until the next flag.
|
|
23
|
+
if (!['criterion', 'passed', 'unmet'].includes(name)) while (args[i + 1] && !args[i + 1].startsWith('--')) options[name].push(args[++i]);
|
|
24
|
+
} else options[name] = value;
|
|
25
|
+
}
|
|
26
|
+
const [command, action] = positionals;
|
|
27
|
+
if ((options.host !== undefined || options.token !== undefined) && command !== 'onboard') throw new Error('--host and --token are only supported by onboard.');
|
|
28
|
+
if (options.kind !== undefined && command !== 'investigate' && (command !== 'recipe' || action !== 'list')) throw new Error('--kind is only supported by recipe list and investigate.');
|
|
29
|
+
if (options.since !== undefined && command !== 'readiness' && command !== 'context') throw new Error('--since is only supported by readiness and context review.');
|
|
30
|
+
if ((options.write || options.all || options.new !== undefined || options.doc !== undefined) && command !== 'context') throw new Error('--write, --all, --new and --doc are only supported by context.');
|
|
31
|
+
if (options.verify && command !== 'onboard') throw new Error('--verify is only supported by onboard. Use run verify for task verification.');
|
|
32
|
+
if (options.verify && options['dry-run']) throw new Error('Do not combine --verify with --dry-run. Plain onboard performs read-only inspection.');
|
|
33
|
+
if (!command || command === 'help' || options.help) {
|
|
34
|
+
console.log(`CYC Stack — portable skill chaining and evidence-based delivery
|
|
35
|
+
|
|
36
|
+
Setup (project-local; no publication or global installation):
|
|
37
|
+
cyc init [--project PATH] [--hosts auto|claude,codex,cursor] [--dry-run] (default: auto-detect)
|
|
38
|
+
cyc activate [--project PATH] [--dry-run] (plugin installs: opt this project in)
|
|
39
|
+
cyc doctor --project PATH
|
|
40
|
+
cyc onboard [--project PATH] [--verify] [--host auto|codex|claude|cursor] [--session ID] [--token TOKEN]
|
|
41
|
+
(inspect setup and this request's hooks; --verify executes configured checks)
|
|
42
|
+
cyc uninstall --project PATH [--dry-run]
|
|
43
|
+
|
|
44
|
+
Discover:
|
|
45
|
+
cyc playbooks
|
|
46
|
+
cyc route --goal "What you want to accomplish" (advisory suggestion)
|
|
47
|
+
cyc investigate [--path PATH...] [--goal TEXT] [--run ID] [--limit 8] [--kind investigation|verification]
|
|
48
|
+
(read-only matching context, file evidence and project recipes)
|
|
49
|
+
cyc recipe list [--path PATH...] [--goal TEXT] [--run ID] [--kind investigation|verification]
|
|
50
|
+
cyc recipe run --recipe ID [--run ID]
|
|
51
|
+
(execute an applicable authorized recipe; retain diagnostic evidence)
|
|
52
|
+
|
|
53
|
+
Component context docs (docs/context/):
|
|
54
|
+
cyc context review [--run ID | --since YYYY-MM-DD | --all] [--write] [--new NAME]
|
|
55
|
+
(map completed runs' changed files to component docs and propose the doc entry from each run's
|
|
56
|
+
record: what changed, what was learned, the decisive check, files with hashes, date and run ID.
|
|
57
|
+
Read-only without --write; --write appends the entries and refreshes INDEX.md)
|
|
58
|
+
cyc context lint [--doc PATH]
|
|
59
|
+
(check the doc layout rules and the index rows, including freshness against Git)
|
|
60
|
+
cyc context measure --path PATH... [--run ID]
|
|
61
|
+
(characters and estimated tokens of INDEX.md plus the matched docs, against every doc and the run records)
|
|
62
|
+
|
|
63
|
+
Execute through your existing AI host:
|
|
64
|
+
cyc run start --goal TEXT --playbook feature [--criterion "done when..."]... [--scope PATH] [--session ID] [--scout FILE --plan TEXT]
|
|
65
|
+
cyc run start --file START.json (goal, playbook, criteria, allowedPaths, session, and optionally scout + plan to record Scout in the same call)
|
|
66
|
+
(no verification.commands? start uses the project's declared test command and says which)
|
|
67
|
+
Later run commands find the single active run themselves; pass --run ID (or --session) when several are active.
|
|
68
|
+
cyc run next --run ID
|
|
69
|
+
cyc run record --run ID --summary "What this stage established" [--assessment FILE] [--artifact PATH]... [--criteria-passed "evidence" | --criterion-evidence JSON] [--status failed|blocked]
|
|
70
|
+
cyc run record --file HANDOFF.json (full form)
|
|
71
|
+
cyc run verify --run ID
|
|
72
|
+
cyc run prove-red --run ID [--tests PATH...]
|
|
73
|
+
(bug-fix/feature: new tests must fail on the run-start code; refactor: they must pass on it)
|
|
74
|
+
cyc run finish --run ID --summary "Result and limits" --assessment FILE --criterion-evidence JSON [--artifact PATH]...
|
|
75
|
+
(from build or verify: record build, prove new tests, verify, record verify and deliver, and complete;
|
|
76
|
+
artifacts default to the files this run changed; run next gives the assessment template)
|
|
77
|
+
cyc run finish --file FINISH.json (summary, assessment, criterionEvidence; optional runId and artifacts)
|
|
78
|
+
cyc run retry --run ID --stage build --reason "What changed in the approach"
|
|
79
|
+
cyc run accept-failure --run ID --check CHECK_ID --reason "Why this pre-existing failure is unrelated"
|
|
80
|
+
cyc run complete --run ID
|
|
81
|
+
cyc run status --run ID
|
|
82
|
+
cyc run recover --run ID (read-only diagnosis and next action; preserves work and budgets)
|
|
83
|
+
cyc run review --run ID (refresh the shared developer/PR review artifact)
|
|
84
|
+
cyc run review-capture --run ID --file CAPTURE.json (reviewer, optional scope)
|
|
85
|
+
cyc run review-record --run ID --file REVIEW.json (reviewId, evidence, identity or null, findings)
|
|
86
|
+
cyc run pause|resume|stop --run ID
|
|
87
|
+
|
|
88
|
+
Deliver the reply:
|
|
89
|
+
cyc check-reply FILE [--session ID | --expanded]
|
|
90
|
+
(the Stop gate's reply checks on a draft: character count, how much to cut, visual; reads nothing else and writes nothing.
|
|
91
|
+
--session applies that conversation's limit off or expand state)
|
|
92
|
+
cyc readiness --session ID [--since ISO_TIMESTAMP]
|
|
93
|
+
(read-only controller status; uses hook request window, or an explicit diagnostic window)
|
|
94
|
+
cyc packet --session ID --passed "criterion :: evidence"... [--unmet "criterion :: evidence"]... [--artifact PATH]... [--status blocked --blocker TEXT] [--advisory "why no controller run applies"] [--response FILE] --reviewed
|
|
95
|
+
(writes the review packet and runs the delivery gate's checks; the Stop gate checks your final reply itself.
|
|
96
|
+
Cursor needs --response, the exact reply, to find its session's packet)
|
|
97
|
+
|
|
98
|
+
All commands accept --project PATH. Criteria file: [{"id":"saved","description":"Survives reload"}].
|
|
99
|
+
Store handoff files under .cyc/runs/ID/ to avoid changing the source being verified.
|
|
100
|
+
New implementation runs require Scout, Verify, and Deliver assessments; run next lists required fields.
|
|
101
|
+
See docs/work-assessments.md for the compact JSON contract and knowledge lifecycle.
|
|
102
|
+
The host agent reads and executes the returned skill; CYC does not launch paid model calls.
|
|
103
|
+
Configure verification.commands in .cyc/config.json; without them, executable runs use the project's declared test command or are refused.
|
|
104
|
+
Hook activation/trust must be checked in your host; doctor does not certify it.`);
|
|
105
|
+
process.exit(0);
|
|
106
|
+
}
|
|
107
|
+
let root = resolve(options.project ?? process.cwd());
|
|
108
|
+
if (!options.project) {
|
|
109
|
+
let cursor = root;
|
|
110
|
+
while (true) {
|
|
111
|
+
if (existsSync(resolve(cursor, '.cyc/config.json'))) { root = cursor; break; }
|
|
112
|
+
const parent = dirname(cursor);
|
|
113
|
+
if (parent === cursor) break;
|
|
114
|
+
cursor = parent;
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
// A missing --run means the single active run here; a record or finish file may name its run.
|
|
118
|
+
if (command === 'run' && action !== 'start' && options.run === undefined && !(['record', 'finish'].includes(action) && options.file)) options.run = activeRun(root, options.session);
|
|
119
|
+
let result;
|
|
120
|
+
if (command === 'investigate' || command === 'recipe') {
|
|
121
|
+
const tools = await import('../scripts/project-tools.mjs');
|
|
122
|
+
const selection = { paths: options.path ?? [], goal: options.goal, run: options.run, ...(options.limit ? { limit: Number(options.limit) } : {}) };
|
|
123
|
+
if (command === 'investigate') result = tools.investigateProject(root, { ...selection, kind: options.kind });
|
|
124
|
+
else if (action === 'list') result = tools.listRecipes(root, { ...selection, all: !options.path && !options.goal && !options.run, kind: options.kind });
|
|
125
|
+
else if (action === 'run') {
|
|
126
|
+
if (options['dry-run']) throw new Error('Use recipe list to inspect without execution; recipe run does not accept --dry-run.');
|
|
127
|
+
if (!options.recipe) throw new Error('--recipe is required.');
|
|
128
|
+
result = tools.runRecipe(root, options.recipe, { run: options.run });
|
|
129
|
+
if (!options.verbose) result.results = result.results.map(({ id, command, args, passed, exitCode, error, errorCode, stdout, stderr }) => ({ id, command, args, passed, exitCode, error, errorCode, outputTail: `${stdout ?? ''}${stderr ?? ''}`.trim().split('\n').slice(-15).join('\n') }));
|
|
130
|
+
} else throw new Error('Use recipe list or recipe run.');
|
|
131
|
+
} else if (command === 'context') {
|
|
132
|
+
const context = await import('../scripts/context-review.mjs');
|
|
133
|
+
if (action === 'review') result = context.reviewContext(root, { run: options.run, since: options.since, all: !!options.all, write: !!options.write, newDoc: options.new });
|
|
134
|
+
else if (action === 'lint') result = context.lintContext(root, { doc: options.doc });
|
|
135
|
+
else if (action === 'measure') result = context.measureContext(root, { paths: options.path ?? [], run: options.run });
|
|
136
|
+
else throw new Error('Use context review, context lint, or context measure.');
|
|
137
|
+
} else if (command === 'onboard') {
|
|
138
|
+
result = (await import('../scripts/onboarding.mjs')).onboardProject(root, { verify: !!options.verify, host: options.host, session: options.session, token: options.token });
|
|
139
|
+
} else if (['init', 'install', 'uninstall', 'doctor', 'activate'].includes(command)) {
|
|
140
|
+
const installer = await import('../scripts/install.mjs');
|
|
141
|
+
if (command === 'activate') result = await installer.activateProject(root, { dryRun: !!options['dry-run'] });
|
|
142
|
+
else if (command === 'doctor') result = await installer.doctorProject(root);
|
|
143
|
+
else if (command === 'uninstall') result = await installer.uninstallProject(root, { dryRun: !!options['dry-run'] });
|
|
144
|
+
else result = await installer.installProject(root, { hosts: !options.hosts || options.hosts === 'auto' ? installer.detectHosts(root) : options.hosts.split(','), dryRun: !!options['dry-run'] });
|
|
145
|
+
} else if (command === 'check-reply') {
|
|
146
|
+
if (!action) throw new Error('check-reply needs the draft file: cyc check-reply .cyc/runtime/reply.md');
|
|
147
|
+
const { checkReply } = await import('../scripts/response-gate.mjs');
|
|
148
|
+
const { allowsLongResponse } = await import('../scripts/response-mode.mjs');
|
|
149
|
+
let expanded = !!options.expanded;
|
|
150
|
+
if (options.session) {
|
|
151
|
+
// The conversation's own setting decides the cap, as it does at Stop.
|
|
152
|
+
const statePath = resolve(root, '.cyc/runtime', `${options.session}.state.json`);
|
|
153
|
+
if (!existsSync(statePath)) throw new Error(`No hook state for session ${options.session} at ${statePath}.`);
|
|
154
|
+
expanded = allowsLongResponse(JSON.parse(readFileSync(statePath, 'utf8').replace(/^/, '')));
|
|
155
|
+
}
|
|
156
|
+
const report = checkReply(readFileSync(resolve(root, action), 'utf8'), { expanded });
|
|
157
|
+
result = { ok: report.issues.length === 0, file: action, ...report, ...(report.issues.length ? {} : { send: 'Send this text unchanged; the Stop gate counts the same way.' }) };
|
|
158
|
+
} else if (command === 'readiness') {
|
|
159
|
+
result = (await import('../scripts/run-gate.mjs')).sessionReadiness({ root, session: options.session, since: options.since });
|
|
160
|
+
} else if (command === 'packet') {
|
|
161
|
+
result = (await import('../scripts/packet.mjs')).writePacket(root, { session: options.session, responseFile: options.response, status: options.status, blocker: options.blocker, advisory: options.advisory, passed: options.passed ?? [], unmet: options.unmet ?? [], artifacts: options.artifact ?? [], reviewed: !!options.reviewed });
|
|
162
|
+
} else if (command === 'playbooks') result = catalog;
|
|
163
|
+
else if (command === 'route') {
|
|
164
|
+
if (!options.goal) throw new Error('--goal is required.');
|
|
165
|
+
result = routeTask(options.goal);
|
|
166
|
+
} else if (command === 'run') {
|
|
167
|
+
switch (action) {
|
|
168
|
+
case 'start': {
|
|
169
|
+
let input;
|
|
170
|
+
if (options.file) {
|
|
171
|
+
fileOnly(options, ['file', 'project', 'verbose']);
|
|
172
|
+
input = inputObject(options.file, ['goal', 'playbook', 'criteria', 'allowedPaths', 'session', 'scout', 'plan', 'evidenceVersion', 'requirements', 'reviewPolicy']);
|
|
173
|
+
for (const key of ['goal', 'playbook', 'session', 'plan']) if (input[key] !== undefined && typeof input[key] !== 'string') throw new Error(`${key} must be a string.`);
|
|
174
|
+
if (input.scout !== undefined && !object(input.scout)) throw new Error('scout must be the Scout assessment object (run start without it returns the template).');
|
|
175
|
+
if (input.criteria !== undefined && (!Array.isArray(input.criteria) || !input.criteria.length || input.criteria.some(item => !object(item) || typeof item.id !== 'string' || typeof item.description !== 'string'))) throw new Error('criteria must be a nonempty array of {id, description} string records.');
|
|
176
|
+
if (input.allowedPaths !== undefined && (!Array.isArray(input.allowedPaths) || input.allowedPaths.some(p => typeof p !== 'string'))) throw new Error('allowedPaths must be an array of paths.');
|
|
177
|
+
} else input = { goal: options.goal, playbook: options.playbook, criteria: options.criteria ? readJSON(options.criteria) : options.criterion ? options.criterion.map((description, index) => ({ id: `c${index + 1}`, description })) : undefined, allowedPaths: options.scope ?? [], session: options.session, scout: options.scout ? readJSON(options.scout) : undefined, plan: options.plan };
|
|
178
|
+
// Without an explicit session, the run belongs to the calling conversation when the host names it.
|
|
179
|
+
input.session ??= callerSession();
|
|
180
|
+
result = startRun(root, input); break;
|
|
181
|
+
}
|
|
182
|
+
case 'next': result = nextRun(root, options.run); break;
|
|
183
|
+
case 'status': result = readRun(root, options.run); break;
|
|
184
|
+
case 'recover': result = recoverRun(root, options.run); break;
|
|
185
|
+
case 'record': {
|
|
186
|
+
if (!options.file && options.summary) {
|
|
187
|
+
result = quickHandoff(root, options.run, { status: options.status, summary: options.summary, artifacts: options.artifact ?? [], passedEvidence: options['criteria-passed'], criterionEvidence: options['criterion-evidence'] ? parseJSON(options['criterion-evidence'], '--criterion-evidence') : undefined, nextAction: options.next, assessment: options.assessment ? readJSON(options.assessment) : undefined });
|
|
188
|
+
break;
|
|
189
|
+
}
|
|
190
|
+
if (!options.file) throw new Error('Use --summary TEXT (quick form) or --file HANDOFF.json.');
|
|
191
|
+
const packet = readJSON(options.file);
|
|
192
|
+
if (options.run && packet.runId !== options.run) throw new Error('--run and handoff runId differ.');
|
|
193
|
+
result = recordHandoff(root, packet); break;
|
|
194
|
+
}
|
|
195
|
+
case 'verify': result = verifyRun(root, options.run); break;
|
|
196
|
+
case 'prove-red': result = proveRun(root, options.run, { tests: options.tests }); break;
|
|
197
|
+
case 'finish': {
|
|
198
|
+
let input;
|
|
199
|
+
if (options.file) {
|
|
200
|
+
fileOnly(options, ['file', 'project', 'verbose', 'run', 'session']);
|
|
201
|
+
input = inputObject(options.file, ['runId', 'summary', 'artifacts', 'passedEvidence', 'criterionEvidence', 'assessment', 'acceptFailures', 'testProof']);
|
|
202
|
+
// A test proof exemption belongs to the verify assessment; agents also put it at the top
|
|
203
|
+
// level, so it is moved there unless the assessment already has a different one.
|
|
204
|
+
if ('testProof' in input) {
|
|
205
|
+
if (input.assessment !== undefined && !object(input.assessment)) throw new Error('assessment must be an object.');
|
|
206
|
+
if (input.assessment && 'testProof' in input.assessment && !isDeepStrictEqual(input.assessment.testProof, input.testProof)) throw new Error('testProof is given twice, at the top level and in assessment, with different values. Keep one.');
|
|
207
|
+
input.assessment = { ...input.assessment, testProof: input.testProof };
|
|
208
|
+
delete input.testProof;
|
|
209
|
+
}
|
|
210
|
+
if ((input.runId !== undefined && (typeof input.runId !== 'string' || !input.runId)) || typeof input.summary !== 'string' || !input.summary.trim()) throw new Error('Finish JSON needs a nonempty summary string (runId is optional when one run is active).');
|
|
211
|
+
if (options.run && input.runId && options.run !== input.runId) throw new Error('--run and finish runId differ.');
|
|
212
|
+
if (input.artifacts !== undefined && (!Array.isArray(input.artifacts) || input.artifacts.some(p => typeof p !== 'string' || !p))) throw new Error('artifacts must be an array of paths.');
|
|
213
|
+
if (!object(input.assessment)) throw new Error('assessment must be an object.');
|
|
214
|
+
if (input.criterionEvidence !== undefined && (!object(input.criterionEvidence) || Object.values(input.criterionEvidence).some(v => typeof v !== 'string' || !v.trim()))) throw new Error('criterionEvidence must map criterion IDs to evidence strings.');
|
|
215
|
+
if (input.passedEvidence !== undefined && (typeof input.passedEvidence !== 'string' || !input.passedEvidence.trim())) throw new Error('passedEvidence must be a nonempty string.');
|
|
216
|
+
for (const path of input.artifacts ?? []) readFileSync(projectFile(root, inputPath(root, path)));
|
|
217
|
+
// finishRun checks evidence and assessments against the run before any test runs.
|
|
218
|
+
options.run = options.run ?? input.runId ?? activeRun(root, options.session);
|
|
219
|
+
} else input = { summary: options.summary, artifacts: options.artifact, passedEvidence: options['criteria-passed'], criterionEvidence: options['criterion-evidence'] ? parseJSON(options['criterion-evidence'], '--criterion-evidence') : undefined, assessment: options.assessment ? readJSON(options.assessment) : {} };
|
|
220
|
+
result = finishRun(root, options.run, input); break;
|
|
221
|
+
}
|
|
222
|
+
case 'retry': result = retryRun(root, options.run, { stage: options.stage, reason: options.reason }); break;
|
|
223
|
+
case 'accept-failure': result = acceptFailure(root, options.run, { check: options.check, reason: options.reason }); break;
|
|
224
|
+
case 'complete': result = completeRun(root, options.run); break;
|
|
225
|
+
case 'review': result = reviewRun(root, options.run); break;
|
|
226
|
+
case 'review-capture':
|
|
227
|
+
if (!options.file) throw new Error('review-capture needs --file JSON with reviewer and optional scope.');
|
|
228
|
+
result = captureReview(root, options.run, inputObject(options.file, ['reviewer', 'scope'])); break;
|
|
229
|
+
case 'review-record':
|
|
230
|
+
if (!options.file) throw new Error('review-record needs --file JSON with reviewId, evidence, identity and findings.');
|
|
231
|
+
result = recordReview(root, options.run, inputObject(options.file, ['reviewId', 'evidence', 'identity', 'findings'])); break;
|
|
232
|
+
case 'pause': case 'resume': case 'stop': result = controlRun(root, options.run, action); break;
|
|
233
|
+
default: throw new Error('Unknown run action. Use cyc help.');
|
|
234
|
+
}
|
|
235
|
+
} else throw new Error(`Unknown command ${command}. Use cyc help.`);
|
|
236
|
+
if (command === 'run' && !options.verbose) result = compact(action, result, root, options);
|
|
237
|
+
console.log(JSON.stringify(result, null, 2));
|
|
238
|
+
if (result?.ok === false || ['halted', 'exhausted', 'blocked'].includes(result?.status) || result?.passed === false) process.exitCode = 1;
|
|
239
|
+
} catch (error) {
|
|
240
|
+
console.error(JSON.stringify({ ok: false, error: error.message }));
|
|
241
|
+
process.exitCode = 1;
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
function object(value) { return value !== null && typeof value === 'object' && !Array.isArray(value); }
|
|
245
|
+
// Hand-written JSON on Windows often has single backslashes in paths (C:\work), which JSON
|
|
246
|
+
// rejects. Retry once with only the invalid escapes doubled; valid escapes are left alone.
|
|
247
|
+
function parseJSON(source, label) {
|
|
248
|
+
if (source.charCodeAt(0) === 0xFEFF) source = source.slice(1);
|
|
249
|
+
try { return JSON.parse(source); } catch (error) {
|
|
250
|
+
try { return JSON.parse(source.replace(/\\(?!["\\/bfnrt]|u[0-9a-fA-F]{4})/g, '\\\\')); }
|
|
251
|
+
catch { throw new Error(`${label}: ${error.message}`); }
|
|
252
|
+
}
|
|
253
|
+
}
|
|
254
|
+
function readJSON(path) { return parseJSON(readFileSync(resolve(path), 'utf8'), path); }
|
|
255
|
+
function inputObject(path, keys) {
|
|
256
|
+
const value = readJSON(path);
|
|
257
|
+
if (!object(value)) throw new Error('Input JSON must be an object.');
|
|
258
|
+
for (const key of Object.keys(value)) if (!keys.includes(key)) throw new Error(`Unknown input field: ${key}`);
|
|
259
|
+
return value;
|
|
260
|
+
}
|
|
261
|
+
function fileOnly(options, allowed) {
|
|
262
|
+
const extra = Object.keys(options).filter(key => !allowed.includes(key));
|
|
263
|
+
if (extra.length) throw new Error(`Do not mix --file with field arguments: ${extra.map(key => `--${key}`).join(', ')}.`);
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
// A check that also failed before the run is the agent's call: name it and the one way to accept
|
|
267
|
+
// it, rather than a generic retry that repeats the same failure until the run is exhausted.
|
|
268
|
+
function preexistingHint(ids) {
|
|
269
|
+
return `${ids.join(', ')} also failed on the run-start code. If ${ids.length > 1 ? 'they are' : 'it is'} unrelated to this change, add "acceptFailures": [${ids.map(id => `{"check": "${id}", "reason": "<why it is unrelated>"}`).join(', ')}] to FINISH.json and run finish again; an accepted check is excused only while it fails as it did then. If this change caused it, fix it instead.`;
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
function compact(action, result, root, options) {
|
|
273
|
+
if (!result || typeof result !== 'object' || ['status', 'recover'].includes(action)) return result;
|
|
274
|
+
const id = result.runId ?? result.id ?? options.run;
|
|
275
|
+
if (['review-capture', 'review-record'].includes(action)) { const { files, ...receipt } = result; return receipt; }
|
|
276
|
+
if (action === 'prove-red') return result;
|
|
277
|
+
if (action === 'finish') return result.failedAt === 'verify' && 'verificationStatus' in result ? { ...compact('verify', result, root, options), finished: false, failedAt: 'verify' } : result;
|
|
278
|
+
if (action === 'verify') {
|
|
279
|
+
const recovery = result.passed ? null : recoverRun(root, id);
|
|
280
|
+
return { runId: id, status: result.status, passed: result.passed, sourceStable: result.sourceStable, changedPaths: result.changedPaths, verificationStatus: result.verificationStatus, acceptedPreexistingFailures: result.acceptedPreexistingFailures, ...(result.acceptedFailuresThatChanged ? { acceptedFailuresThatChanged: result.acceptedFailuresThatChanged } : {}), ...(result.failedAtRunStart ? { failedAtRunStart: result.failedAtRunStart } : {}), ...(result.awaitingAcceptance ? { awaitingAcceptance: true } : {}),
|
|
281
|
+
results: (result.results ?? []).map(item => ({ id: item.id, passed: item.passed, exitCode: item.exitCode, error: item.error, outputTail: `${item.stdout ?? ''}${item.stderr ?? ''}`.trim().split('\n').slice(-15).join('\n') })),
|
|
282
|
+
receiptPath: result.receiptPath, ...(recovery ? { recovery } : {}), hint: result.passed ? 'Record verify with --criterion-evidence (or --criteria-passed for a single criterion).'
|
|
283
|
+
: result.awaitingAcceptance && result.status === 'running' ? preexistingHint(result.failedAtRunStart)
|
|
284
|
+
: result.failedAtRunStart?.length && result.status === 'running' ? `${recovery.nextAction.instruction} Separately, ${result.failedAtRunStart.join(', ')} also failed on the run-start code; accept only if unrelated.`
|
|
285
|
+
: recovery.nextAction.instruction };
|
|
286
|
+
}
|
|
287
|
+
if (!id) return result;
|
|
288
|
+
const next = nextRun(root, id);
|
|
289
|
+
const { previousHandoff, criteria, limits, assessmentRequired, assessmentTemplate, ...rest } = next;
|
|
290
|
+
// Agents often read only the first lines (| head -40), so what they act on comes first and the
|
|
291
|
+
// long fill-in template last.
|
|
292
|
+
const lead = Object.fromEntries(['runId', 'status', 'stage', 'attempt', 'finishTemplate', 'verificationSource', 'verificationCommands', 'baseline', 'baselineFailures', 'testProof', 'finishWith', 'ledgerPath', 'feedback'].filter(key => key in rest).map(key => [key, rest[key]]));
|
|
293
|
+
return { ...lead, criteria: criteria.map(item => item.id), previous: previousHandoff ? { stage: previousHandoff.stage, status: previousHandoff.status, summary: previousHandoff.summary } : null, ...rest, ...(result.acceptedFailures ? { acceptedFailures: result.acceptedFailures } : {}), ...(['paused', 'blocked', 'halted', 'exhausted', 'stopped'].includes(next.status) ? { recovery: recoverRun(root, id) } : {}), assessmentRequired, ...(rest.finishTemplate ? {} : { assessmentTemplate }) };
|
|
294
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"playbooks": [
|
|
4
|
+
{"id":"investigation","description":"Explain behavior or causes from evidence without changing the product.","stages":["scout","deliver"],"requiresChecks":false},
|
|
5
|
+
{"id":"explore","description":"Compare distinct candidate approaches before committing to one.","stages":["frame","understand","explore","challenge","deliver"],"requiresChecks":false},
|
|
6
|
+
{"id":"plan","description":"Sequence a substantial change into verifiable units.","stages":["frame","understand","impact","design","challenge","deliver"],"requiresChecks":false},
|
|
7
|
+
{"id":"feature","description":"Build changed behavior and verify its affected consumers.","stages":["scout","build","verify","deliver"],"requiresChecks":true},
|
|
8
|
+
{"id":"bug-fix","description":"Reproduce a failure, locate its cause, repair and regression-check it.","stages":["scout","build","verify","deliver"],"requiresChecks":true},
|
|
9
|
+
{"id":"refactor","description":"Improve structure while proving preserved behavior.","stages":["scout","build","verify","deliver"],"requiresChecks":true},
|
|
10
|
+
{"id":"performance","description":"Measure a baseline and establish a targeted performance improvement.","stages":["scout","build","verify","deliver"],"requiresChecks":true},
|
|
11
|
+
{"id":"review","description":"Identify consequential, supported findings in existing work.","stages":["scout","challenge","verify","deliver"],"requiresChecks":false},
|
|
12
|
+
{"id":"verify","description":"Evaluate an executable result against explicit acceptance criteria.","stages":["scout","verify","deliver"],"requiresChecks":true},
|
|
13
|
+
{"id":"experience","description":"Improve the complete user journey and verify connected behavior.","stages":["scout","explore","build","verify","deliver"],"requiresChecks":true},
|
|
14
|
+
{"id":"teach","description":"Explain a concept through the learner's project and optional practice.","stages":["frame","understand","teach","deliver"],"requiresChecks":false},
|
|
15
|
+
{"id":"handoff","description":"Prepare reviewable evidence, decisions and remaining limitations.","stages":["understand","verify","deliver"],"requiresChecks":false},
|
|
16
|
+
{"id":"resume","description":"Reconstruct and revalidate context before continuing work.","stages":["remember","understand","deliver"],"requiresChecks":false},
|
|
17
|
+
{"id":"reflect","description":"Propose evidence-backed improvements without silently changing doctrine.","stages":["remember","reflect","deliver"],"requiresChecks":false},
|
|
18
|
+
{"id":"evaluate","description":"Compare a workflow against a baseline using recorded outcomes.","stages":["frame","understand","explore","verify","reflect","deliver"],"requiresChecks":true}
|
|
19
|
+
]
|
|
20
|
+
}
|
package/docs/README.md
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# CYC documentation
|
|
2
|
+
|
|
3
|
+
Start with the guide for the task at hand. Current operating guidance lives here; the source checkout's component history lives in `docs/context/`.
|
|
4
|
+
|
|
5
|
+
## Install and use CYC
|
|
6
|
+
|
|
7
|
+
| Need | Guide |
|
|
8
|
+
| --- | --- |
|
|
9
|
+
| Installation, updates, removal and host activation | [Installation](installation.md) |
|
|
10
|
+
| Configure real checks and recover interrupted work | [Onboarding and recovery](onboarding-recovery.md) |
|
|
11
|
+
| Understand Scout, Build, Verify and Deliver | [Engineering workflow](cyc-workflow.md) |
|
|
12
|
+
| Find a method and its responsibility | [Method map](cyc-method-map.md) |
|
|
13
|
+
| Retain and reuse project knowledge | [Project context](context.md) |
|
|
14
|
+
| Discover and run reusable project checks | [Project tools](project-tools.md) |
|
|
15
|
+
| Understand what checks can establish | [Validation](validation.md) |
|
|
16
|
+
|
|
17
|
+
## Inspect and adapt the methods
|
|
18
|
+
|
|
19
|
+
| Need | Guide |
|
|
20
|
+
| --- | --- |
|
|
21
|
+
| Controller state, commands and source-bound evidence | [Runtime](runtime.md) |
|
|
22
|
+
| Stage handoffs and evidence labels | [Skill contract](skill-contract.md) |
|
|
23
|
+
| Required work assessments | [Work assessments](work-assessments.md) |
|
|
24
|
+
| Impact investigation | [Impact analysis](impact-analysis.md) |
|
|
25
|
+
| Engineering judgment and code review | [Principles](principles.md), [architecture decisions](code-quality.md), [code standards](engineering/code-standards.md) |
|
|
26
|
+
| State ownership and failure handling | [Domain design](engineering/domain-design.md), [failure handling](engineering/failure-handling.md) |
|
|
27
|
+
| Final replies and progress updates | [Response standard](response-standard.md) |
|
|
28
|
+
| Write focused skill instructions | [Skill craft](skill-craft.md) |
|
|
29
|
+
|
|
30
|
+
Source-only rollout, distribution and community plans live in `docs/maintainers/`. Development task fixtures live in `evals/`. These directories are not copied into application installations.
|
|
@@ -0,0 +1,39 @@
|
|
|
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>
|
|
@@ -0,0 +1,44 @@
|
|
|
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>
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="450" height="530" viewBox="0 0 450 530" role="img" aria-labelledby="title desc">
|
|
2
|
+
<title id="title">Carry the reasoning forward</title>
|
|
3
|
+
<desc id="desc">Retrieve and recheck project knowledge, apply team standards to the next change, verify the result and retain lessons for future work.</desc>
|
|
4
|
+
<defs>
|
|
5
|
+
<linearGradient id="surface" x2="1" y2="1"><stop stop-color="#111d3a"/><stop offset="1" stop-color="#182f49"/></linearGradient>
|
|
6
|
+
<marker id="forward" markerWidth="7" markerHeight="7" refX="6" refY="3.5" orient="auto"><path d="m0 0 7 3.5L0 7" fill="#73e0cc"/></marker>
|
|
7
|
+
</defs>
|
|
8
|
+
<rect width="450" height="530" rx="20" fill="url(#surface)"/>
|
|
9
|
+
<g font-family="Segoe UI, Arial, sans-serif">
|
|
10
|
+
<text x="32" y="36" fill="#73e0cc" font-size="12" font-weight="700" letter-spacing="2">CONTEXT ENGINEERING</text>
|
|
11
|
+
<text x="31" y="80" fill="#f5f8ff" font-size="31" font-weight="700" letter-spacing="-.6">Carry the reasoning</text>
|
|
12
|
+
<text x="31" y="115" fill="#f5f8ff" font-size="31" font-weight="700" letter-spacing="-.6">forward.</text>
|
|
13
|
+
<text x="32" y="144" fill="#bfcee5" font-size="15">The next task starts with the team's knowledge.</text>
|
|
14
|
+
<path d="M37 205V275M37 315V385" fill="none" stroke="#73e0cc" stroke-width="2"/>
|
|
15
|
+
<path d="m33 269 4 7 4-7m-8 110 4 7 4-7" fill="none" stroke="#73e0cc" stroke-width="2"/>
|
|
16
|
+
<circle cx="37" cy="190" r="6" fill="#73e0cc"/>
|
|
17
|
+
<text x="64" y="197" fill="#f5f8ff" font-size="24" font-weight="650">Project knowledge</text>
|
|
18
|
+
<text x="64" y="222" fill="#bfcee5" font-size="15">Decisions, constraints, failure history</text>
|
|
19
|
+
<text x="64" y="244" fill="#73e0cc" font-size="12" font-weight="700" letter-spacing="1.2">RETRIEVE + RECHECK</text>
|
|
20
|
+
<circle cx="37" cy="300" r="6" fill="#85b8ff"/>
|
|
21
|
+
<text x="64" y="307" fill="#f5f8ff" font-size="24" font-weight="650">The next change</text>
|
|
22
|
+
<text x="64" y="332" fill="#bfcee5" font-size="15">Team standards, scoped work</text>
|
|
23
|
+
<text x="64" y="354" fill="#85b8ff" font-size="12" font-weight="700" letter-spacing="1.2">APPLY + BUILD</text>
|
|
24
|
+
<circle cx="37" cy="410" r="6" fill="#f2ce82"/>
|
|
25
|
+
<text x="64" y="417" fill="#f5f8ff" font-size="24" font-weight="650">Reviewable evidence</text>
|
|
26
|
+
<text x="64" y="442" fill="#bfcee5" font-size="15">Checks, findings, remaining limits</text>
|
|
27
|
+
<text x="64" y="464" fill="#f2ce82" font-size="12" font-weight="700" letter-spacing="1.2">VERIFY + HAND OFF</text>
|
|
28
|
+
<path d="M37 425v55q0 12-12 12h-3q-10 0-10-12V187q0-12 12-12h12" fill="none" stroke="#73e0cc" stroke-opacity=".6" stroke-width="1.5" marker-end="url(#forward)"/>
|
|
29
|
+
<text x="64" y="504" fill="#d1e9e4" font-size="13">Retain verified lessons for future work</text>
|
|
30
|
+
</g>
|
|
31
|
+
</svg>
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="390" viewBox="0 0 1200 390" role="img" aria-labelledby="title desc">
|
|
2
|
+
<title id="title">CYC Stack: carry the reasoning forward</title>
|
|
3
|
+
<desc id="desc">Project knowledge informs the next change. The work produces reviewable evidence, and verified lessons return to the project for future developers and AI sessions.</desc>
|
|
4
|
+
<defs>
|
|
5
|
+
<linearGradient id="surface" x2="1" y2="1"><stop stop-color="#111d3a"/><stop offset="1" stop-color="#182f49"/></linearGradient>
|
|
6
|
+
<pattern id="grid" width="32" height="32" patternUnits="userSpaceOnUse"><path d="M32 0H0V32" fill="none" stroke="#bdcfed" stroke-opacity=".06"/></pattern>
|
|
7
|
+
<marker id="forward" markerWidth="7" markerHeight="7" refX="6" refY="3.5" orient="auto"><path d="m0 0 7 3.5L0 7" fill="#73e0cc"/></marker>
|
|
8
|
+
</defs>
|
|
9
|
+
<rect width="1200" height="390" rx="20" fill="url(#surface)"/>
|
|
10
|
+
<rect width="1200" height="390" rx="20" fill="url(#grid)"/>
|
|
11
|
+
<g font-family="Segoe UI, Arial, sans-serif">
|
|
12
|
+
<text x="56" y="49" fill="#73e0cc" font-size="13" font-weight="700" letter-spacing="2.4">CONTEXT ENGINEERING / SHARED DELIVERY</text>
|
|
13
|
+
<text x="54" y="104" fill="#f5f8ff" font-size="39" font-weight="700" letter-spacing="-.8">Carry the reasoning forward.</text>
|
|
14
|
+
<text x="56" y="135" fill="#bfcee5" font-size="18">The team's knowledge becomes the next task's starting point.</text>
|
|
15
|
+
<path d="M358 216H439" stroke="#73e0cc" stroke-width="2" marker-end="url(#forward)"/>
|
|
16
|
+
<path d="M743 216H824" stroke="#73e0cc" stroke-width="2" marker-end="url(#forward)"/>
|
|
17
|
+
<g transform="translate(56 177)">
|
|
18
|
+
<path d="M0 0H296" stroke="#73e0cc" stroke-width="3"/>
|
|
19
|
+
<text y="34" fill="#73e0cc" font-size="12" font-weight="700" letter-spacing="2">01 / RETRIEVE + RECHECK</text>
|
|
20
|
+
<text y="69" fill="#f5f8ff" font-size="25" font-weight="650">Project knowledge</text>
|
|
21
|
+
<text y="100" fill="#bfcee5" font-size="17">Decisions, constraints, failure history</text>
|
|
22
|
+
</g>
|
|
23
|
+
<g transform="translate(449 177)">
|
|
24
|
+
<path d="M0 0H284" stroke="#85b8ff" stroke-width="3"/>
|
|
25
|
+
<text y="34" fill="#85b8ff" font-size="12" font-weight="700" letter-spacing="2">02 / APPLY + BUILD</text>
|
|
26
|
+
<text y="69" fill="#f5f8ff" font-size="25" font-weight="650">The next change</text>
|
|
27
|
+
<text y="100" fill="#bfcee5" font-size="17">Team standards, scoped work</text>
|
|
28
|
+
</g>
|
|
29
|
+
<g transform="translate(834 177)">
|
|
30
|
+
<path d="M0 0H310" stroke="#f2ce82" stroke-width="3"/>
|
|
31
|
+
<text y="34" fill="#f2ce82" font-size="12" font-weight="700" letter-spacing="2">03 / VERIFY + HAND OFF</text>
|
|
32
|
+
<text y="69" fill="#f5f8ff" font-size="25" font-weight="650">Reviewable evidence</text>
|
|
33
|
+
<text y="100" fill="#bfcee5" font-size="17">Checks, findings, remaining limits</text>
|
|
34
|
+
</g>
|
|
35
|
+
<path d="M1080 303v25H200q-24 0-24-24v-7" fill="none" stroke="#73e0cc" stroke-opacity=".65" stroke-width="1.5" marker-end="url(#forward)"/>
|
|
36
|
+
<rect x="387" y="315" width="468" height="27" rx="13.5" fill="#152740"/>
|
|
37
|
+
<text x="621" y="334" text-anchor="middle" fill="#d1e9e4" font-size="14">Retain verified lessons for the next teammate and task</text>
|
|
38
|
+
</g>
|
|
39
|
+
</svg>
|