Tianyi Cui
d942204759
Retrospective on the whole stacked-PR effort. Adds a "Landing changes cleanly: gates, Codex, and scope" section capturing the workflow lessons the effort surfaced, and two codebase-specific traps to Defensive patterns. The through-line: a mechanical gate proves lines ran and types check, never that a test guards anything or that prose is accurate — so layer the human/AI judgment on top, in order, and keep each unit honestly scoped: - prove every regression test RED on the unfixed code (top-billed, not a nit) - run the FULL test:coverage, not an isolated -t filter (test-isolation bugs) - spend Codex on what gates can't see (prose/RFC/comment drift, self-introduced fix bugs), scoped to ONE concern per review (a two-fix prompt timed out) - a mid-review cleanup that exceeds the reviewed RFC scope goes in a NEW stacked PR; enumerate consumers + grill before deleting a seam - regenerate a generated artifact as part of the invalidating edit, not as a gate to fail; lint:fix before hand-fixing - read a failure before reacting: ENOSPC watcher exhaustion is environmental, not a code regression Defensive-patterns additions (both bit us this cycle): spawn narrows non-null stdout/stderr only from a literal stdio tuple; AgentLoop.create() drops options.meta (only the async factory threads it).
DeepSeek Harness
Monorepo for the DeepSeek Harness group.
Projects
- DeepSeek Code — DeepSeek's coding agent product.
Development
This monorepo is built on the Cordis framework (vendored as source under vendor/), microkernel-style: everything is a plugin.
pnpm install
pnpm run test # vitest
pnpm run demo:echo # runnable echo-agent example (no API key needed)
pnpm run demo:coding # the real DeepSeek coding agent (needs DEEPSEEK_API_KEY)
For humans, start with the development guide for local setup, hooks, environment variables, and quality gates, then read the architecture design before package work. Local context lives in packages/ and vendor/.
For agents, follow AGENTS.md.