AI-ASSISTED DELIVERY // SUPERVISED WORKFLOW

AIWORKFLOW

A structured workflow for using AI to accelerate planning, implementation, debugging, documentation, and refinement — while keeping architecture and final judgment human-owned.

08 Steps04 PrinciplesPlanningCodingQADocumentation

“AI accelerates execution; it does not set requirements, architecture, or final decisions.”

THE PIPELINE // 08 STEPS

Workflow steps

Every delivery starts from a defined problem and a documented architecture. AI accelerates the implementation and documentation phases — Musa owns every decision point.

Human InputArchitecture & PlanningAI-Assisted ExecutionReview & Output
01Human Input

Define the problem

Start from the real business or technical problem, not a feature request — establish what needs to be true when the work is done.

Problem framing, success criteria, and scope are fully human-defined.

AI tooling

requirements-to-implementation workflows
02Human Input

Convert ambiguity into requirements

Turn a vague or messy business problem into concrete, testable requirements before any implementation starts.

Problem framing, success criteria, and scope are fully human-defined.

AI tooling

requirements-to-implementation workflows
03Architecture & Planning

Break into modules

Split the requirements into clear technical modules or phases that can be built and reviewed independently.

Module boundaries, technical approach, and dependencies are Musa’s decisions.

AI tooling

AI-assisted architecture planning
04Architecture & Planning

Generate implementation prompts

Write specific, scoped prompts for each module so AI-assisted implementation stays aligned with the architecture already decided.

Module boundaries, technical approach, and dependencies are Musa’s decisions.

AI tooling

prompt engineering
05AI-Assisted Execution

Use Claude Code / multi-agent planning

Use Claude Code and multi-agent planning to structure and parallelise implementation work across modules under a documented plan.

Output is reviewed, broken behaviour is diagnosed, and acceptance is Musa’s call.

AI tooling

Claude Code workflowmulti-agent planning
06AI-Assisted Execution

Build and debug

Run AI-assisted debugging alongside manual verification to resolve issues, with Musa deciding what's actually broken and why.

Output is reviewed, broken behaviour is diagnosed, and acceptance is Musa’s call.

AI tooling

AI-assisted debuggingcode generation supervision
07Review & Output

Review architecture, UI, and QA

Review generated code against the architecture and UI/UX direction using QA prompts — approving, correcting, or rejecting AI output before it ships.

Architecture is accepted, QA pass/fail decided, and docs reviewed before hand-over.

AI tooling

UI/UX iterationQA promptscode generation supervision
08Review & Output

Document and hand over

Use AI-assisted documentation to keep the system's source-of-truth docs current for handover and future work.

Architecture is accepted, QA pass/fail decided, and docs reviewed before hand-over.

AI tooling

AI-assisted documentation

PRINCIPLES // 04

Workflow principles

The rules that govern how AI tooling is used — and what it is never allowed to replace.

01 / PRINCIPLE

AI accelerates execution; it does not set requirements, architecture, or final decisions.

02 / PRINCIPLE

Every AI-assisted output is reviewed against a documented spec before it's accepted.

03 / PRINCIPLE

Prompt engineering, multi-agent planning, and QA prompting are supervised practices, not automation left to run unchecked.

04 / PRINCIPLE

AI-assisted delivery is treated as a professional workflow capability, not a novelty.

APPLIED WORKFLOW // 04 EXAMPLES

Workflow in practice

Real applications of the AI-assisted delivery workflow — each example is documented and linked to the system or capability it informed.

01 / EXAMPLE

CRM module planning

Used AI-assisted architecture planning to design CRM module structure and business-process mapping for the Multi-Company CRM Operating System.

02 / EXAMPLE

Founder Command Center

Used requirements-to-implementation workflows to turn founder-level reporting needs into a structured decision-support layer.

03 / EXAMPLE

Portfolio system build

Built this Moses Portfolio itself through a phased, documented Claude Code workflow — source-of-truth docs first, then scaffold, data layer, design system, and pages in sequence.

04 / EXAMPLE

Debugging and documentation workflows

Uses AI-assisted debugging and documentation to keep implementation and architecture notes consistent as the system evolves.

HUMAN IN THE LOOP // 06 CHECKPOINTS

Where the human stays in control

AI-assisted delivery does not mean AI-autonomous delivery. Every critical decision point is a human checkpoint — not a handoff.

01 · Requirements

Human-defined

Every project starts from a problem Musa has identified and scoped — not a task issued to AI.

02 · Architecture

Human-owned

Module structure, data models, service boundaries, and technical approach are Musa's decisions.

03 · Implementation

Reviewed against spec

Every AI-generated code block is reviewed against the documented architecture before acceptance.

04 · Debugging

Human-verified

Musa diagnoses the root cause and confirms the fix — AI proposes, human validates.

05 · Documentation

Human-checked

Source-of-truth docs are reviewed and corrected by Musa before any content is accepted.

06 · Final decisions

Always Musa's

No output ships without explicit human approval. AI does not release, deploy, or decide.

The short version: AI handles the speed work. Musa handles the judgment calls. The systems in this portfolio are not AI’s work — they are Musa’s systems, delivered through an AI-accelerated workflow.

WORKFLOW → CAPABILITIES

How the workflow supports each domain

AI-assisted delivery is not a replacement for domain knowledge — it accelerates the delivery of work that Musa already understands. See all capability domains →

CAPABILITY DOMAIN

Backend & Web Systems

AI assists

AI assists with API scaffolding, route generation, and boilerplate — keeping implementation aligned to a pre-agreed architecture.

Musa owns

Module structure, data models, authentication strategy, and integration points are Musa-owned decisions.

CAPABILITY DOMAIN

Cloud-Native & Infrastructure

AI assists

AI assists with Kubernetes manifest drafting, config structuring, and deployment architecture planning.

Musa owns

Security posture, resource sizing, cloud-provider choices, and deployment strategy are human decisions.

CAPABILITY DOMAIN

CRM & Business Systems

AI assists

AI assists with module planning, business-process mapping, and CRM configuration logic structuring.

Musa owns

Business rules, data relationships, workflow priorities, and operational requirements are defined by Musa.

CAPABILITY DOMAIN

Automation & Integrations

AI assists

AI assists with workflow pattern design, API integration scaffolding, and event-trigger logic structuring.

Musa owns

Business logic, error-handling rules, and system-to-system trust boundaries are human-owned.

CAPABILITY DOMAIN

Security & Diagnostics

AI assists

AI assists with spec review, documentation of access-control patterns, and diagnostic note-taking.

Musa owns

All security decisions, risk assessment, access-control policy, and diagnostic conclusions are Musa-verified.

CAPABILITY DOMAIN

AI-Assisted Delivery

AI assists

Claude Code is the primary AI tooling — used for scaffolding, multi-agent planning, debugging, and documentation.

Musa owns

Musa defines the requirements, selects the prompting strategy, reviews every output, and accepts or rejects AI work.

AI does not replace domain knowledge — it accelerates delivery of decisions already made

EXPLORE FURTHER

Explore the systems delivered through this workflow.

Every system in the portfolio was planned, implemented, and documented using the structured AI-assisted delivery workflow described on this page.