AI Factory V2 — Workflow Templates and Status Pages

AI Factory V2 — Workflow Templates and Status Pages 
 Standard internal templates for AI Factory workflows. 
 Local source directory: /Users/makinja/system/specs/ai-factory/templates 
 README.md 
 # ALAI AI Factory V2 Templates

Reusable BookStack/MC templates for internal AI Factory workflows.

These templates support the standard flow:

1. CEO/operator request
2. Workflow status page
3. Evidence package
4. Postflight and lessons learned

## Files

- `request-template.md` — intake/request template for a new AI Factory workflow.
- `workflow-status-template.md` — running status page template for MC parent/process/subtasks.
- `evidence-package-template.md` — evidence bundle template for ready/done review.
- `postflight-lessons-template.md` — postflight summary and lessons template.

## Guardrails

- Evidence paths must point to existing files or command output artifacts.
- Memory, HiveMind, and LightRAG are advisory and must not replace evidence.
- P2P peer verification is required only when current policy classifies the task as risky/H/backend/core/security/user-facing/deploy-impacting.
- Final QA/MC gates remain mandatory.
- No deploy or production mutation unless the workflow explicitly authorizes it.
 
 request-template.md 
 # AI Factory Request — <goal>

**Request date:** <YYYY-MM-DD> 
**Requester:** <name/role> 
**Owner:** <john|agent|company> 
**Priority:** <H|M|L> 
**Domain/route:** <backend|frontend|devops|qa|security|product|data|general> 
**Recommended company:** <CodeCraft|Vizu|FlowForge|Proveo|Securion|AgentForge|Skybound|John>

## 1. Goal

<One or two paragraphs describing the business/user outcome.>

## 2. Scope

### In scope

- <item>

### Out of scope

- <item>

## 3. Acceptance Criteria

- [ ] <observable criterion with evidence path or command>
- [ ] <observable criterion with evidence path or command>

## 4. Risk Classification

- P2P pair programming required: <yes|no|unknown>
- Reason: <policy reason or classification output>
- Production/deploy impact: <yes|no>
- Security/data sensitivity: <yes|no>

## 5. Planned Workflow Objects

- MC parent task: <#id or pending>
- MC process tracker: <process-id or pending>
- BookStack status page: <url or pending>
- Evidence package: <path or pending>

## 6. Evidence Expectations

- Local spec path: `<path>`
- Test/build evidence: `<path>`
- P2P verifier thread/message: `<mesh-thr-* / mesh-msg-* or n/a>`
- Final QA evidence: `<path or n/a>`

## 7. Guardrails

- No production mutation unless explicitly approved.
- No unsupported claims without existing evidence paths.
- Memory/LightRAG/HiveMind may support context but are not final evidence.
 
 workflow-status-template.md 
 # AI Factory Workflow Status — <goal>

**Status:** <draft|active|blocked|ready_for_review|done> 
**Updated:** <YYYY-MM-DD HH:mm TZ> 
**MC parent:** <#id> 
**Process:** `<process-id>` 
**BookStack request/spec:** <url> 
**Owner:** <name/agent>

## Summary

<Current state in 3-5 bullets.>

## Workflow Map

| Step | MC task | Owner/company | Status | Evidence |
|---|---:|---|---|---|
| Plan/spec | <#id> | <owner> | <status> | `<path/url>` |
| Build/implementation | <#id> | <owner> | <status> | `<path/url>` |
| P2P pre-verifier | <#id/thread> | <agent/company> | <status> | `<mesh/path>` |
| Final QA/verification | <#id> | <owner> | <status> | `<path/url>` |
| Docs/postflight | <#id> | <owner> | <status> | `<path/url>` |

## Current Evidence

- Implementation evidence: `<path>`
- P2P evidence: `<path or n/a>`
- Smoke/test evidence: `<path>`
- BookStack/docs evidence: `<path/url>`

## Risks and Blockers

| Blocker | Owner | Since | Next action |
|---|---|---|---|
| <blocker> | <owner> | <date> | <action> |

## Next Actions

1. <next action>
2. <next action>
3. <next action>

## Decision Log

| Date | Decision | Evidence/why |
|---|---|---|
| <date> | <decision> | `<path/url>` |

## Claim Discipline

- Every completion/status claim above must have an existing evidence path or command output.
- If an evidence path is missing, mark the item `pending` or `blocked` instead of claiming completion.
 
 evidence-package-template.md 
 # AI Factory Evidence Package — <goal>

**Generated:** <timestamp> 
**MC parent:** <#id> 
**Primary task:** <#id> 
**Owner:** <owner> 
**BookStack:** <url>

## Verdict

**Status:** <PASS|PARTIAL|BLOCKED> 
**Reason:** <short evidence-based reason>

## Evidence Index

| Evidence type | Path/ID | Status | Notes |
|---|---|---|---|
| Local spec | `<path>` | <exists/missing> | <notes> |
| Implementation diff/file list | `<path/command>` | <exists/missing> | <notes> |
| Syntax/build check | `<path/command>` | <pass/fail/not-run> | <notes> |
| Tests/smoke check | `<path/command>` | <pass/fail/not-run> | <notes> |
| P2P verifier | `<mesh-thr-* / mesh-msg-* / path>` | <pass/partial/blocked/n/a> | <notes> |
| Final QA | `<path>` | <pass/partial/blocked/n/a> | <notes> |
| BookStack/docs | `<url/path>` | <exists/missing> | <notes> |

## Commands Run

```bash
# command
 
 Result: <pass/fail> 
Output artifact: <path> 
 P2P Verification 
 
 Required by policy: <yes|no> 
 Thread: <mesh-thr-...> 
 Prompt message: <mesh-msg-...> 
 Response message: <mesh-msg-...> 
 Materialized evidence: <path> 
 End state: <PASS|PARTIAL|ANSWERED|BLOCKED|DECLINED> 
 
 Known Gaps 
 
 

 
 
 Final Notes 
 
 No deploy/production mutation unless evidence explicitly says otherwise. 
 Memory/LightRAG/HiveMind writeback is advisory and should be listed separately from review evidence. 
 
 
## postflight-lessons-template.md

```markdown
# AI Factory Postflight — <goal>

**Date:** <YYYY-MM-DD> 
**MC parent:** <#id> 
**Process:** `<process-id>` 
**Owner:** <owner> 
**Final status:** <done|partial|blocked>

## Outcome

- Delivered: <what changed>
- Not delivered: <remaining gaps>
- User/business impact: <short statement>

## Evidence

- Primary evidence package: `<path>`
- BookStack status/spec: `<url>`
- P2P verifier evidence: `<path or n/a>`
- QA/test evidence: `<path or n/a>`

## Timeline

| Time | Event | Evidence |
|---|---|---|
| <time> | <event> | `<path/url>` |

## What Worked

- <lesson>

## What Failed / Slowed Us Down

- <lesson>

## Metrics

| Metric | Value | Source |
|---|---:|---|
| Total MC tasks | <n> | `<command/path>` |
| P2P attempts | <n> | `<command/path>` |
| P2P pass/partial/blocked | `<n/n/n>` | `<command/path>` |
| Rework count | <n> | `<command/path>` |
| Approx cost | <value/unknown> | `<path>` |

## Follow-up Tasks

- <#id> — <title/status>

## Knowledge Writeback

- Memory writeback: <queued|ok|blocked>
- HiveMind writeback: <queued|ok|blocked>
- LightRAG outbox: <queued|ok|blocked>
- Evidence: `<path>`

## Recommendation

<Continue / pause / expand / revise policy, with evidence-based reason.>
 
 Notes 
 
 These templates are internal operating docs, not product/customer promises. 
 Evidence paths must exist before ready/done claims. 
 P2P verifier evidence complements but does not replace final QA/MC gates.