# Assemble

> Use when executing implementation plans with independent tasks in the current session

- **Type:** Skill
- **Install:** `agentstack add skill-devnomad-byte-techneering-assemble`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [devnomad-byte](https://agentstack.voostack.com/s/devnomad-byte)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [devnomad-byte](https://github.com/devnomad-byte)
- **Source:** https://github.com/devnomad-byte/techneering/tree/main/skills/assemble

## Install

```sh
agentstack add skill-devnomad-byte-techneering-assemble
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Assemble: Subagent-Driven Execution

Execute plans by dispatching a fresh subagent per task, with two-stage review after each: spec compliance review first, then code quality review.

## Core Principle

```
FRESH SUBAGENT PER TASK + TWO-STAGE REVIEW = HIGH QUALITY.
Never skip reviews. Never reuse context between tasks.
```

## Model Selection

Use the least powerful model that can handle each role:
- **Mechanical tasks** (1-2 files, clear specs): fast/cheap model
- **Integration tasks** (multi-file, debugging): standard model
- **Architecture/review tasks**: most capable model

## Steps

### Step 1: Read Plan and Extract Tasks

Read the implementation plan. Extract all tasks and create a todo list.

### Step 2: Execute Tasks (Per-Task Loop)

For each task:

#### 2a. Dispatch Implementer Subagent

**Frontend Detection:** Before dispatching, check if the task involves frontend/UI work. Match against the Frontend Detection Rules in `tn:compass` (keywords: page/component/UI/layout/style/React/Vue/CSS/Tailwind/form/button/animation etc.). If matched, invoke `tn:craft` first to get aesthetic guidance, then include that guidance in the implementer prompt.

Use `./implementer-prompt.md` template. Provide full task text (never make subagent read the plan file).

**One commit per task:** the implementer commits its own work before returning (the review stages below compare that commit's diff). Each task = one commit, so `2b`/`2c` reviews have a clean BASE_SHA→HEAD_SHA range per task.

Handle status:
- **DONE:** Proceed to spec compliance review
- **DONE_WITH_CONCERNS:** Read concerns, address if needed, proceed
- **NEEDS_CONTEXT:** Provide missing context and re-dispatch
- **BLOCKED:** Assess blocker, provide context or re-dispatch with better model

**Never** ignore an escalation or force the same model to retry without changes.

#### 2b. Dispatch Spec Reviewer Subagent

Use `./spec-reviewer-prompt.md` template. Verify implementer built what was requested (nothing more, nothing less).

- If issues → implementer fixes → re-review
- Don't skip the re-review

#### 2c. Dispatch Code Quality Reviewer Subagent

Use `./code-quality-reviewer-prompt.md` template. Only after spec compliance passes.

- If issues → implementer fixes → re-review
- Don't skip the re-review

#### 2d. Mark Task Complete

Mark the task as complete in the todo list and in `techneering/changes//tasks.md`.

### Step 3: Parallel Scheduling

Analyze task dependencies, build DAG:
- Independent tasks can be dispatched in parallel (max 3 concurrent)
- Dependent tasks run in topological order
- Avoid resource conflicts between parallel tasks

## Red Flags

| Thought | Reality |
|---------|---------|
| "Skip review to speed up" | Review is quality assurance, not an optional step |
| "Let the subagent read the plan file" | Must provide full text — don't make subagent read files |
| "Ignore the subagent's BLOCKED" | BLOCKED = needs your help, not "try again" |
| "Run code quality review before spec review" | Order is irreversible: spec first, then quality |

## Quick Reference

| Dimension | Key point |
|-----------|-----------|
| Flow | implementer → spec review → code quality review → next task |
| Subagents | Independent per task, don't inherit session context |
| Parallel | Independent tasks can run parallel, max 3 concurrent |
| Templates | implementer-prompt.md / spec-reviewer-prompt.md / code-quality-reviewer-prompt.md |
| Path placeholder | Always use `techneering/changes//` |

## Next Step

When done:
- Normal case (all tasks complete) → invoke `tn:gate` to run test verification
- Issue encountered → invoke `tn:diagnose` for systematic debugging
- User requests stop → end the current flow

## Guardrails

- Never skip reviews (spec compliance OR code quality)
- Never start code quality review before spec compliance passes
- Never move to next task while either review has open issues
- Never make subagent read plan file — provide full text instead
- Never ignore subagent questions or escalations
- If reviewer finds issues: implementer fixes → reviewer re-reviews → repeat until approved
- Follow tn:redgreen for each task and tn:diagnose if issues arise

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [devnomad-byte](https://github.com/devnomad-byte)
- **Source:** [devnomad-byte/techneering](https://github.com/devnomad-byte/techneering)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-devnomad-byte-techneering-assemble
- Seller: https://agentstack.voostack.com/s/devnomad-byte
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.