Try it yourself

# Try it yourself

Start with a folder, add Markdown files, hand it to your agent. That's DWSD.

## 1. Create a folder for your organization

```bash
mkdir my-org && cd my-org
```

## 2. Add an ORG.md root file (a unit with unit-type: organization)

```yaml
---
type: unit
unit-type: organization
member-of: "[[]]"
contributes-to: "[[]]"
---
# <Your organization name>

<One line — the top-level DWSD entity. Add work systems, teams, and individuals as separate .md files.>
```

## 3. Add a work system file

A work system is a unit whose `unit-type` includes `work-system` (e.g. `unit-type: [department, work-system]`). `flightlevel` is still required but no longer the marker. Add one per domain, team, or delivery unit.

```yaml
---
type: unit
unit-type: [department, work-system]   # `work-system` in unit-type marks it a work system
flightlevel: 2           # the flight level — required on a work system (carried, not the marker)
contributes-to: "[[]]"   # the higher work system this one feeds
member-of: "[[]]"
delegator: "[[]]"        # who delegated this domain
version: "1.0"           # Date/Version (with decision_date)
decision_date: "2026-01-01"
review_date: "2026-04-01"
# term: ""               # only when used for a role
---
## Purpose

<Why this domain exists.>

## Key Responsibilities

- <What the domain is accountable for.>

## Customers and Deliverables

- "[[]]" — <what they receive>

## Dependencies

<What it depends on — link work systems with [[…]].>

## External Constraints

- <Constraints from outside the domain.>

## Key Challenges

- <Current challenges / strain.>

## Key Resources

- <People, budget, tools.>

## Delegator Responsibilities

- <What the delegator stays accountable for.>

## Competencies, Qualities and Skills

- <What it takes to keep this domain.>

## Key Metrics and Monitoring

- <How performance is observed.>

## Evaluation Schedule

<When and how the domain is reviewed.>
```

## 4. Hand the folder to your agent

The dwsd-md Claude Code plugin loads automatically from .claude-plugin/plugin.json — clone the
dwsd-markdown repo into your project for instant agent context.

Explore templates and examples on GitHub:
https://github.com/worksystems-design/dwsd-markdown