DataArt/artisyn-implementation-harness / skills/implementation-harness
implementation-harness
FlaggedInstall the portable AI-dev harness, rebuild its operational graph standalone, harvest project skill improvements into its canonical templates, package direct canonical edits into a portable bundle, or apply canonical updates to an existing project. Use /implementation-harness launch, /implementation-harness reindex-graph, or /implementation-harness patch harvest|prepare|apply.
canonical/docs/Engineering Guide/03 Engineer Role.md
View on GitHub# Engineer Role
> **Engineer = creative direction. AI = follows the workflow and assists with implementation.**
## The Mental Model
Think of the AI assistant as a senior pair-programmer who knows the codebase conventions inside out, never forgets a checklist, and can type faster than any human — but still needs _you_ to decide what to build and why.
The engineer owns the problem. The AI owns the execution.
## What the Engineer Does
- **Defines the goal** — picks up the ticket, understands the business context, decides the approach
- **Makes architectural calls** — chooses patterns, resolves trade-offs, says "no" when a suggestion doesn't fit
- **Reviews every step** — the AI stops at each phase boundary; the engineer reads the output and approves or redirects
- **Catches what the AI can't** — domain nuance, product intent, "this is technically correct but wrong for us"
## What the AI Does
- **Follows the workflow** — runs the `{{SKILL_PREFIX}}dev` lifecycle (Context → Ceremony → Plan → Implement → Test → Document) without skipping steps
- **Knows the conventions** — reads the skills, respects the architecture, applies project-specific rules automatically
- **Implements incrementally** — one step at a time, surfacing blockers early rather than delivering a big surprise
- **Keeps the docs honest** — updates READMEs and skills as part of the same task, not as an afterthought
## Division of Responsibility
| Concern | Owner | Reason |
| ------------------- | ------------- | ------------------------------------------------------ |
| What to build | Engineer | Requires business context and product judgement |
| How to structure it | Engineer + AI | Collaborative — AI proposes, engineer decides |
| Writing the code | AI | AI is fast and consistent; engineer reviews |
| Testing | AI + Engineer | AI runs the suite; engineer validates intent |
| Documentation | AI | AI has full context of what changed; engineer approves |
## In Practice
The engineer is never idle. While the AI is implementing, the engineer is reading the plan, thinking ahead, spotting risks. The moment the AI pauses for confirmation, the engineer is ready with a decision — not catching up.
This keeps velocity high without trading away quality or ownership.
---
→ See `Engineering Guide/Lifecycles/01 Dev Lifecycle.md` for the ticket-to-PR process.
→ See `Engineering Guide/04 AI Coding Tool Compatibility.md` for how the harness maps to specific AI tools.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |