AGENT SKILL

write-vibe-adr

Create or update Architecture Decision Records for the Mistral Vibe Python CLI. Use when a design discussion creates a new architectural constraint, when an undocumented convention causes confusion or review feedback, or when architecture guidance in docs/adr or AGENTS.md must be changed.

License 许可
Apache-2.0
所属仓库
Mr-Shine09/Zephyr
最近更新
2026-08-23
Stars
★ 0
Forks
0

01 前言 Front Matter

name
write-vibe-adr
metadata
{ "display-name": "Write Vibe ADR", "default-prompt": "Use $write-vibe-adr to document a Vibe architecture decision and register it for agents.", "short-description": "Create architecture ADRs for Vibe" }
description
Create or update Architecture Decision Records for the Mistral Vibe Python CLI. Use when a design discussion creates a new architectural constraint, when an undocumented convention causes confusion or review feedback, or when architecture guidance in docs/adr or AGENTS.md must be changed.

03 SKILL.md 正文

Write Vibe ADR

Vibe ADRs are concise, agent-facing architecture rules in docs/adr/. Writing an ADR is a two-step process: write the document, then register it in the Architecture Decisions table in AGENTS.md.

When To Create An ADR

  • A design discussion creates a new architecture rule, constraint, or direction.
  • An existing convention is undocumented and caused a bug, review comment, or repeated confusion.
  • A pattern applies across a Vibe area or boundary, not just one file.
  • Future work should follow a direction that may differ from the current architecture.

Do not create ADRs for one-off implementation choices, formatting rules, or behavior already enforced by linting.

Steps

1. Confirm the scope

Use one ADR when the decision is cohesive. Split ADRs when separate agents would need to read them for unrelated change areas.

Existing ADR topics:

  • 0001 - architecture principles
  • 0002 - core engine and delivery surfaces
  • 0003 - event-driven agent loop
  • 0004 - typed permissioned tools
  • 0005 - layered configuration
  • 0006 - local sessions
  • 0007 - extension mechanisms
  • 0008 - feature instrumentation

2. Determine the next number

ls docs/adr/

Use the next sequential number, zero-padded to 4 digits: 0009-my-decision.md.

3. Write the ADR

Use this format:

# 0009 Decision Title

## Decision

What we decided. Include concrete rules and current-vs-aspirational direction when relevant.

## Rationale

Why this decision exists. Name the ambiguity, pressure, or tradeoff.

## Agent Guidance

- Concrete instructions an agent should follow while changing code.
- Keep guidance task-oriented and easy to scan.

## Flag To User When

- Situations where an agent must stop and ask because current code or user request conflicts with the ADR direction.

Keep ADRs concise. Match the existing 20-50 line style. Do not add a status field.

4. Register in AGENTS.md

Add or update a row in the Architecture Decisions table:

| <task trigger> | [0009 Decision Title](docs/adr/0009-my-decision.md) |

The trigger text must describe what the agent is changing, not vague architecture language.

Good triggers:

  • "Adding a new delivery surface, protocol bridge, or UI-owned behavior"
  • "Changing tool args/results, permissions, output limits, or adapters"
  • "Changing session transcript shape, metadata, resume, rewind, or migrations"

Bad triggers:

  • "Working on architecture"
  • "When relevant"
  • "Making decisions"

If the ADR is not registered in AGENTS.md, agents will not reliably discover it.

Common Mistakes

Mistake Fix
Writing the ADR but not updating AGENTS.md Always do both.
Using vague trigger text Name concrete code-change scenarios.
Duplicating another ADR Reference or update the existing ADR instead.
Writing a human essay Keep it short, directive, and agent-facing.
Adding status fields Vibe ADRs intentionally mix current and aspirational decisions without status.

04 同仓库更多 Skills

Mr-Shine09
Mr-Shine09/Zephyr

prompts

暂无简介

★ 0
Mr-Shine09
Mr-Shine09/Zephyr

write-vibe-tests

Write or refactor Mistral Vibe tests with proper decoupling. Use when adding behavior coverage, testing ports/adapters, replacing brittle mocks, creating fakes, adding characterization tests before refactors, or changing tests under tests/ for vibe/core, vibe/cli, vibe/acp, tools, config, sessions, skills, hooks, MCP, or setup.

★ 0
Mr-Shine09
Mr-Shine09/Zephyr

instrument-feature-analytics

Plan analytics instrumentation for a feature. Use when implementing any feature — every feature must ship with telemetry. Decides which events and properties the metrics need (funnels, adoption, status flows), checks compatibility with the existing datalake and event registry, and walks through local, staging, and production verification.

★ 0
Mr-Shine09
Mr-Shine09/Zephyr

create-vibe-feature

Add or modify a feature in the Mistral Vibe Python CLI while following the app architecture ADRs. Use when working in vibe/core, vibe/cli, vibe/acp, vibe/setup, built-in tools, config, sessions, skills, hooks, MCP, connectors, or other Vibe feature code.

★ 0
Mr-Shine09
Mr-Shine09/Zephyr

vibe-textual-ui

Textual TUI widget and TCSS conventions for Mistral Vibe. Use when building or styling Textual widgets, writing TCSS rules, working with selectable lists, tool headers, theme variables, or UI component layout.

★ 0
Mr-Shine09
Mr-Shine09/Zephyr

vibe-python-style

Python coding conventions for Mistral Vibe. Use when writing, reviewing, or refactoring Python code in the Vibe codebase. Covers style, type hints, imports, Pydantic patterns, logging, error handling, and file I/O.

★ 0