# Stackbrief

> Create a source-cited architectural brief before planning or making a repository change.

- **Type:** Skill
- **Install:** `agentstack add skill-mojeebdev-stackbrief-agent`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [mojeebdev](https://agentstack.voostack.com/s/mojeebdev)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [mojeebdev](https://github.com/mojeebdev)
- **Source:** https://github.com/mojeebdev/stackbrief/tree/main/agent
- **Website:** https://stackbrief.peerfix.dev

## Install

```sh
agentstack add skill-mojeebdev-stackbrief-agent
```

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

## About

# StackBrief: the architectural brief before a code change

Use this workflow when a developer asks to change code, investigate a likely change, review the impact of a planned edit, or asks which files matter before implementation.

StackBrief is static, local analysis. It provides evidence and constraints; it does not replace runtime verification, product decisions, or developer judgement.

## Before changing code

1. Identify the most likely source file to change. If there are several plausible entry points, state the ambiguity and ask the developer which one they intend to touch.
2. From the repository root, run:

   ```sh
   stackbrief brief --file 
   ```

3. Read the brief before proposing or applying the implementation. Carry forward the cited routes, services, databases, external APIs, direct dependents, test targets, and unknowns that are relevant to the requested change.
4. Do not invent architecture that the brief does not evidence. Explicitly distinguish static findings from assumptions needing runtime, configuration, feature-flag, or product confirmation.

## Before a commit or review

After a real change has been staged, run:

```sh
stackbrief brief --staged
```

Use the result as a compact review checklist. Do not stage artificial changes merely to invoke this command.

## When StackBrief is unavailable

Explain that the pre-change brief could not be generated. Continue only with normal repository inspection, clearly labelling the result as manual rather than StackBrief-derived evidence.

## Principle

The purpose is not to make a developer slower or second-guess them. It is to make the architectural consequences visible before they touch the code or delegate a prompt.

## Source & license

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

- **Author:** [mojeebdev](https://github.com/mojeebdev)
- **Source:** [mojeebdev/stackbrief](https://github.com/mojeebdev/stackbrief)
- **License:** MIT
- **Homepage:** https://stackbrief.peerfix.dev

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-mojeebdev-stackbrief-agent
- Seller: https://agentstack.voostack.com/s/mojeebdev
- 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%.