---
name: dld-status
description: Quick overview of the decision log state — counts by status, recent decisions, and run tracking info.
compatibility: No external dependencies.
metadata:
  dld-kit-version: "1.0.0-rc.4"
---
<!-- Generated by dld-kit from templates/skills/dld-status/SKILL.md. Do not edit: updating the skills overwrites this file. -->

# /dld-status — Decision Log Overview

You are generating a quick overview of the decision log state for the developer.

## Files read

This skill runs no commands. It reads decision files and state files directly:
- `dld.config.yaml` — project configuration (decisions directory, mode)
- `decisions/records/DL-*.md` — all decision records (scan YAML frontmatter for status, tags, timestamp, namespace)
- `decisions/.dld-state.yaml` — run tracking state for audit and snapshot (may not exist)

## Prerequisites

Check that `dld.config.yaml` exists at the repo root. If not, tell the user to run `/dld-init` first and stop.

## Read project context

1. Read `dld.config.yaml` to understand the project structure (flat vs namespaced, decisions directory)
2. Read all decision files in the records subdirectory (`decisions/records/`) to gather statistics

## Generate the overview

### 1. Count decisions by status

Scan all `DL-*.md` files in the records subdirectory (`decisions/records/`, including namespace subdirectories). Read the `status` field from each file's YAML frontmatter. Count:
- `proposed`
- `accepted`
- `deprecated`
- `superseded`

Present as:
```
## Decision Log Status

| Status | Count |
|--------|-------|
| proposed | 3 |
| accepted | 12 |
| deprecated | 2 |
| superseded | 1 |
| **Total** | **18** |
```

### 2. Recent decisions

Show the 5 most recent decisions (by timestamp), with ID, title, status:

```
## Recent Decisions

| ID | Title | Status | Date |
|----|-------|--------|------|
| DL-018 | ... | proposed | 2026-03-07 |
| DL-017 | ... | accepted | 2026-03-06 |
| ...
```

### 3. Decisions by grouping

**Namespaced projects:** Show decision counts per namespace.

```
## By Namespace

| Namespace | Total | Proposed | Accepted |
|-----------|-------|----------|----------|
| billing | 8 | 1 | 7 |
| auth | 5 | 2 | 3 |
| shared | 5 | 0 | 5 |
```

**All projects:** If there are tags in use, show the most active tags (those with the most decisions):

```
## Active Tags

| Tag | Decisions |
|-----|-----------|
| payment-gateway | 4 |
| auth-refactor | 3 |
```

### 4. Run tracking info

Read `decisions/.dld-state.yaml` if it exists. Report:
- Last audit run time and commit hash
- Last snapshot run time

If the file doesn't exist, note that no audits or snapshots have been run yet.

```
## Run History

- **Last audit:** 2026-03-06 at commit `a1b2c3d` (1 day ago)
- **Last snapshot:** 2026-03-05 (2 days ago, covers through DL-015)
```

Or:
```
## Run History

No audits or snapshots have been run yet. Use `/dld-audit` to check for drift.
```

### 5. Proposed decisions needing action

If there are any `proposed` decisions, list them as a call to action:

```
## Pending Implementation

These decisions are proposed but not yet implemented:
- **DL-016**: Rate limiting strategy
- **DL-017**: Cache invalidation approach
- **DL-018**: Error response format

Use `/dld-implement DL-NNN` to implement them.
```