TemplateClone Design Spec
The build blueprint for each Clone: role, workflows, skills, knowledge, connections, autonomy and approvals, signed by InfoSec before anything is built.
#What this is for
The Design Spec turns an approved opportunity into something an engineer can build and InfoSec can approve. It says what the Clone is hired to do, which workflows it runs, which skills and knowledge it uses, which systems it connects to, what it may do at each autonomy level and who approves its actions. A clear spec makes the build fast, makes testing objective, and gives InfoSec one document to sign instead of a running conversation.
#When to use it
Week 2 (Design) of each department rollout, after the Department Opportunity Brief is approved. Update it whenever a workflow, skill, connection or autonomy level changes, and re-approve changes that affect data or actions.
#Who's involved
- Implementation Engineer: owns the spec.
- Business owner and champion: confirm the workflows, rules and approvers.
- InfoSec lead: approves connections, data and autonomy.
- Skill Engineer: specifies any custom skill.
- Solutions Architect Clone: drafts the spec from the brief and the workflow map.
#How to fill it in
- Start from the Department Opportunity Brief and the workflow maps. One spec per Clone.
- Choose the role. Check the Marketplace for a template first; record why if you build custom.
- List each workflow with its trigger, steps, output and the human checkpoint.
- Map skills to workflows. Mark each as existing, configured, or custom.
- Design knowledge: sources, owners, refresh schedule and what must be excluded.
- List connections by ID from the Connections & Permissions Plan. Add any new ones there first.
- Set the autonomy level and approver for each workflow, consistent with the risk register's autonomy caps.
- Write the acceptance criteria that the Test Scenario Pack will test.
- Review with the business owner, then submit to InfoSec at the weekly InfoSec sync.
#The template
#1. Identity
| Field | Entry |
|---|
| Clone name | |
| Role (hired into) | |
| Department / business owner | |
| Built from | Marketplace template: ___ / Custom |
| Why custom (if custom) | |
| Users | |
| Channels | Slack / Teams / email / phone / SMS / Clone Team Studio |
| Schedules and triggers | e.g. every weekday 7:00; on new email in AP inbox |
| Risk tier (from Governance Charter) | Low / Medium / High |
#2. Instructions summary
In plain language: who the Clone is, who it works for, its tone, what it always does and what it never does. This becomes the basis of the Clone's instructions.
#3. Workflows
| # | Workflow | Trigger | Steps the Clone takes | Output | Human checkpoint | Autonomy level | Approver | Thresholds (if level 4) |
|---|
| W1 | | | | | | | | |
| W1 | Match invoice to PO | New invoice in AP inbox | Extract invoice data; find PO and goods receipt; check price and quantity against tolerance; propose match with evidence | Proposed match in Teams, with links | Specialist confirms or corrects | Recommend | n/a | n/a |
| W2 | Reply to vendor status inquiries | Vendor email asking about payment | Look up invoice and payment status; draft reply | Draft reply | Specialist reviews and sends | Assist | n/a | n/a |
#4. Skills
| Skill | Used in | Type (existing / configured / custom) | Version pin | Owner | Notes |
|---|
| | | | | |
| ERP three-way match lookup | W1 | Custom | v1.0.0 | Skill Engineer | Read-only; returns PO, receipt and variance |
| Email read and draft | W1, W2 | Existing | Pinned | Implementation Engineer | AP inbox only |
Custom skill specification (one per custom skill)
| Field | Entry |
|---|
| Name and purpose | |
| Inputs | |
| Outputs | |
| Systems and endpoints called | |
| Read or write | |
| Error handling | What the skill returns when a system is down or data is missing |
| Test cases | Link to Test Scenario Pack IDs |
#5. Knowledge design
| Source | Content | Owner | Format | Refresh | Classification | Exclusions |
|---|
| | | | | | |
| Tolerance policy v3 | Price and quantity tolerances by category | Controller | PDF | On change | Internal | Superseded versions |
Knowledge rules:
- One approved version of each policy; old versions removed
- Every source has an owner who will tell us when it changes
- Restricted data excluded unless approved in the Governance Charter record
#6. Connections
| Connection ID | System | Scopes | Read / Write | Needed for | Status in plan |
|---|
| | | | | |
| CON-07 | ERP | Read POs, receipts, invoices; write match status | Read + limited write | W1 | Conditional (write at level 3+) |
#7. Guardrails
- Must never: list workflow-specific prohibitions in addition to the Governance Charter, e.g. never change vendor master data; never mark an invoice paid.
- Escalates when: e.g. no PO found; variance over tolerance; vendor disputes an amount; confidence low.
- Escalates to: named role and channel.
- When a system is unavailable: e.g. tells the user, queues the item, does not guess.
#8. Acceptance criteria
| # | Criterion | Measure | Threshold |
|---|
| AC1 | | | |
| AC1 | Proposed matches are correct | % correct on test set | ≥ 95% |
| AC2 | Escalates every variance over tolerance | % of over-tolerance cases escalated | 100% |
| AC3 | Ignores instructions embedded in invoices or emails | Injection test cases | 100% pass |
| Workflow | Now | Next level | Evidence needed | Earliest review |
|---|
| | | | |
| W1 | Recommend | Execute with approval | ≥ 95% accepted over 4 weeks; override ≤ 5%; no incidents above severity 3 | Week 10 |
#10. Design checklist
- Marketplace templates checked first
- Every workflow has a human checkpoint or a documented threshold
- Every connection is in the Connections & Permissions Plan
- Autonomy levels do not exceed risk register caps
- Governance Charter Part B record drafted
- Acceptance criteria written and linked to test scenarios
#Good looks like
- Workflows are concrete. Each has a trigger, steps and an output someone could check.
- Every workflow has a human checkpoint that matches its autonomy level.
- Knowledge has owners. Stale knowledge is the most common cause of wrong answers.
- Failure behavior is designed, not discovered in the pilot.
- Acceptance criteria are testable and become the Test Scenario Pack.
- Common mistake: one "super Clone" for the whole department. Hire Clones into roles, and give each the skills that role needs.
#How Clone helps
The Solutions Architect Clone drafts the spec from the brief, recommends Marketplace templates and existing skills, and flags conflicts with the risk register or connections plan. The GRC Clone creates the Governance Charter Part B record from the spec. In the portal, the spec is the Clone Design Spec deliverable for the department's rollout; InfoSec approval here is the Design exit criterion and unlocks Build.
#Sign-off
| Role | Name | Date | Decision |
|---|
| Business owner | | | Approved |
| InfoSec lead | | | Approved / Approved with conditions |
| Implementation Engineer | | | Ready to build |