---
title: "intake:create-system-description"
description: "Launch parallel analysis threads to produce a SOC2-style living document covering architecture, API surface, security patterns, and external dependencies."
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/intake-create-system-description
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T11:30:12.604Z
license: CC-BY-4.0
attribution: "intake:create-system-description — Claudary (https://claudary.paisolsolutions.com/skills/intake-create-system-description)"
---

# intake:create-system-description
Launch parallel analysis threads to produce a SOC2-style living document covering architecture, API surface, security patterns, and external dependencies.

## Overview

# intake:create-system-description

Launch parallel analysis threads to produce a SOC2-style living document covering architecture, API surface, security patterns, and external dependencies.

**Status:** Planned

---

## Overview

The agent runs parallel analysis: one thread maps the architecture (services, databases, queues), another catalogs the API surface area, another traces security patterns (auth, encryption, access controls), and another maps external dependencies. The output is `docs/system-description.md` — a system overview suitable for an auditor or a new senior engineer. This document becomes the shared context for all subsequent workflow phases, and is incrementally updated during execution and holistically reviewed during retrospective.

## Inputs

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `directory` | string | no | Root directory to analyze. Defaults to project root. |

## Outputs

| Name | Type | Path | Description |
|------|------|------|-------------|
| `system-description` | file | `docs/system-description.md` | Living document: architecture, API surface, security, deployments, third-party dependencies |

## Prerequisites

- Documented codebase (from `intake:document-codebase`)
- Characterization tests (from `intake:capture-behavior`)

## Next Steps

The system description is complete. Feature-forge reads it during feature definition. If discovery is needed, proceed to `discovery:create`. Otherwise, proceed directly to `planning:epic-plan`.

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/intake-create-system-description) · https://claudary.paisolsolutions.com