shipping-artifacts

Generates reviewable documentation sets covering architecture, permissions, flows, secrets, and test coverage for AI-built applications.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/Choi-Keith/skill-arsenal-ultra --skill shipping-artifacts-choi-keith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shipping-artifacts
Source: https://github.com/Choi-Keith/skill-arsenal-ultra/tree/main/plugins/pm-skills/pm-ai-shipping/skills/shipping-artifacts
Command: npx skills add https://github.com/Choi-Keith/skill-arsenal-ultra --skill shipping-artifacts-choi-keith

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding agents produce code fast but leave no durable record of intent—what the system should do, who is allowed to do what, where secrets live, and which rules are actually verified. Without these records, no human reviewer or audit agent can judge whether the code is safe to ship. This Skill defines a small, honest documentation set that restores reviewability before release. ## Core Features & Use Cases - Core document set: Defines five mandatory documents—architecture.md, flows.md, permissions.md, variables.md, and tests.md—each with explicit requirements for what must be captured and how a reviewer uses it. - Conditional documents: Adds emails.md, cron.md, seo.md, and automation.md only when the application actually has those capabilities, with one-line notes instead of fabricated empty docs. - Trust-boundary mapping: Captures authorization checks, trust-boundary crossings, side effects, and agent tool surfaces so security and performance audits have an expected-state baseline to compare code against. - Use Case: Before shipping a vibe-coded SaaS app, run this Skill to produce a documentation/ folder that a security auditor can use to verify RLS policies, secret scoping, cron idempotency, and embedded agent guardrails against the actual code. ## Quick Start Ask the AI to generate the shipping-artifacts documentation set for this repository so the app can be reviewed before release.

Frequently Asked Questions about shipping-artifacts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document an AI-built app before shipping it?

Produce a documentation/ folder with five core files: architecture.md, flows.md, permissions.md, variables.md, and tests.md. Each captures a specific review surface—system structure, runtime authorization, access control, secrets, and verification status—so auditors can compare intent against code.

What documents are needed for a security audit of a codebase?

A security audit needs an architecture overview with trust boundaries, a permissions matrix of roles and resources, a secrets-and-variables risk table, and a flows document showing where authorization checks execute. Conditional docs cover cron jobs, emails, and embedded agents when present.

How do I map test coverage against documented rules?

Use the tests.md structure, which separates existing coverage, proposed tests, and gaps into three sections. Each row links a test case to the rule it locks, the expected behavior including rejection cases, and whether CI enforces it.

When should conditional documents like cron.md or automation.md be included?

Include a conditional document only when the application actually has that capability—scheduled tasks, transactional email, indexable routes, or embedded AI agents. If absent, record a one-line note in architecture.md rather than fabricating an empty document.

What are the limitations of this documentation approach?

The documents describe the current system honestly but do not enforce anything themselves; they are the expected-state half of an audit. They also exclude agent runtime context files like CLAUDE.md, which are produced separately during handoff.