# Feedback

> Report a problem with macstack-dev, the macstack.json schema, or the registry — and fix it at the source Arguments: <what went wrong>.

- Skill: `agents-store/feedback-4` (Agent Skill)
- Install (CLI): `npx get-skill add agents-store/feedback-4`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agents-store/feedback-4/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: agents-store (https://skillmd.com/u/agents-store)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/agents-store/feedback-4

---


Use `macstack-dev:feedback` to route the fix, then apply it **at the source**. A fix
applied to a mirror is silently overwritten by the next sync.

| What broke | Where it is fixed |
|---|---|
| A skill's instructions, the folder convention, the merge loop | this plugin |
| The document shape, a table that should be a list, a language rule | this plugin, `documents` and `doc-contracts.json` |
| The schema, a field, an enum, a lint rule of the standard | `macstacks/macstack` |
| A software category, a coverage area | `macstacks/registry` |

When the schema changes, all three copies change together: the canon, any project
mirror and this plugin's bundled fallback. Verify with
`gh api repos/macstacks/macstack/contents/<path>?ref=main`, never with a plain `curl`
against the CDN right after a push — it serves the previous revision and prints a full,
entirely false diff, and the obvious reaction to that diff is to overwrite what you
just published.

Record what was learned in `LEARNINGS.md`: problem, fix, root cause, severity.
