Create app artifact templates skill

Skeletons this metaskill creates in the user's docs/ folder.

by wondelai·MIT license·★ 2,235 Stars on the repo·GitHub ↗

Use now

Files of Create app artifact templates

wondelai/main1 file
artifact-templates.md
Show the full text155 lines

create-app artifact templates

Skeletons this metaskill creates in the user's docs/ folder. Extend-only artifacts (CUSTOMER.md, STRATEGY.md, TECH-DEBT.md) are governed by the section headings named in each phase, not skeletons here.

docs/CREATE-APP-PLAN.md (tracker)

# Create an App Plan

## Context
Intake answers, date started, project specifics. Note whether shipping native iOS (gates Phase 8).

## Phase Status
| Phase | Skill | Status | Artifact | Date |
|---|---|---|---|---|
| 1 | lean-startup | pending | PRODUCT.md, EXPERIMENTS.md | |
| 2 | design-sprint | pending | DESIGN.md, EXPERIMENTS.md | |
| 3 | clean-architecture | pending | ARCHITECTURE.md | |
| 4 | domain-driven-design | pending | ARCHITECTURE.md | |
| 5 | clean-code | pending | TESTING.md | |
| 6 | pragmatic-programmer | pending | TESTING.md, TECH-DEBT.md | |
| 7 | system-design | pending | ARCHITECTURE.md | |
| 8 | ios-hig-design | pending | DESIGN.md | |
| 9 | 37signals-way | pending | PRODUCT.md, STRATEGY.md | |
| 10 | software-design-philosophy | pending | TECH-DEBT.md, ARCHITECTURE.md | |
Statuses: pending · in-progress · awaiting-evidence · done · deferred: <reason> · skipped: <reason>

## Key Decisions
| Date | Phase | Decision | Rationale |
|---|---|---|---|

## Next Actions
- [ ] action (owner, due)

docs/PRODUCT.md

# Product

## Vision
One paragraph.

## MVP Definition
Type, scope, what it deliberately excludes.

## Outcome Roadmap
| Outcome / problem | Job served | Priority | Status |
|---|---|---|---|

## Opportunity Solution Tree Notes

## Hook Model
Trigger → Action → Variable reward → Investment; weakest phase.

## Activation & Retention Plan
| Friction / moment | Fix | Owner | Status |
|---|---|---|---|

## Discovery Cadence
Weekly touchpoint plan.

docs/EXPERIMENTS.md

# Experiments

## Experiment Cards
### EXP-001 — [name]
- Hypothesis: We believe [outcome] if [who] [does what] because [reason]
- Type: sprint / smoke test / concierge / painted door / A-B
- Primary metric & threshold (pre-committed):
- Guardrail metric:
- Decision rule (pivot / persevere / iterate):
- Result & verdict:

## Experiment Backlog
| Idea | ICE (impact/confidence/ease) | Status |
|---|---|---|

docs/ARCHITECTURE.md

# Architecture

## System Context
What the system does, key integrations, load reality (back-of-envelope numbers).

## Layer Map & Dependency Rule
Layers, what depends on what, current violations.
| Violation | Location | Fix | Status |
|---|---|---|---|

## Bounded Contexts & Context Map
Contexts, relationships, anti-corruption layers.

## Domain Glossary (Ubiquitous Language)
| Term | Meaning | Code name |
|---|---|---|

## Data & Storage Decisions
Data models, storage engines, isolation levels, replication, system-of-record vs derived data.

## Decision Log
| Date | Decision | Why | Alternatives rejected |
|---|---|---|---|

docs/TESTING.md

# Testing

## Test Strategy
Pyramid, tooling, what "green" gates.

## Safety Net Map
| Module | Pinned behaviors | Test files | Gaps |
|---|---|---|---|

## Characterization Backlog
- [ ] module (risk, priority)

## CI Gates

docs/DESIGN.md

# Design System

## Design Direction
Signature moment, personality, references.

## Typography
Typefaces, scale, measure, line height, loading strategy.

## Tokens
Spacing scale · color palette (shades, tinted grays) · shadows.

## Components
| Component | Decision | Status |
|---|---|---|

## UX Audit Findings
| Issue | Heuristic | Severity (0-4) | Fix | Status |
|---|---|---|---|---|

## Microinteraction Inventory
| Interaction | Trigger/Rules/Feedback/Loops | Fix | Status |
|---|---|---|---|
1# create-app artifact templates
2 
3Skeletons this metaskill creates in the user's docs/ folder. Extend-only artifacts (CUSTOMER.md, STRATEGY.md, TECH-DEBT.md) are governed by the section headings named in each phase, not skeletons here.
4 
5## docs/CREATE-APP-PLAN.md (tracker)
6 
7```markdown
8# Create an App Plan
9 
10## Context
11Intake answers, date started, project specifics. Note whether shipping native iOS (gates Phase 8).
12 
13## Phase Status
14| Phase | Skill | Status | Artifact | Date |
15|---|---|---|---|---|
16| 1 | lean-startup | pending | PRODUCT.md, EXPERIMENTS.md | |
17| 2 | design-sprint | pending | DESIGN.md, EXPERIMENTS.md | |
18| 3 | clean-architecture | pending | ARCHITECTURE.md | |
19| 4 | domain-driven-design | pending | ARCHITECTURE.md | |
20| 5 | clean-code | pending | TESTING.md | |
21| 6 | pragmatic-programmer | pending | TESTING.md, TECH-DEBT.md | |
22| 7 | system-design | pending | ARCHITECTURE.md | |
23| 8 | ios-hig-design | pending | DESIGN.md | |
24| 9 | 37signals-way | pending | PRODUCT.md, STRATEGY.md | |
25| 10 | software-design-philosophy | pending | TECH-DEBT.md, ARCHITECTURE.md | |
26Statuses: pending · in-progress · awaiting-evidence · done · deferred: <reason> · skipped: <reason>
27 
28## Key Decisions
29| Date | Phase | Decision | Rationale |
30|---|---|---|---|
31 
32## Next Actions
33- [ ] action (owner, due)
34```
35 
36## docs/PRODUCT.md
37 
38```markdown
39# Product
40 
41## Vision
42One paragraph.
43 
44## MVP Definition
45Type, scope, what it deliberately excludes.
46 
47## Outcome Roadmap
48| Outcome / problem | Job served | Priority | Status |
49|---|---|---|---|
50 
51## Opportunity Solution Tree Notes
52 
53## Hook Model
54Trigger → Action → Variable reward → Investment; weakest phase.
55 
56## Activation & Retention Plan
57| Friction / moment | Fix | Owner | Status |
58|---|---|---|---|
59 
60## Discovery Cadence
61Weekly touchpoint plan.
62```
63 
64## docs/EXPERIMENTS.md
65 
66```markdown
67# Experiments
68 
69## Experiment Cards
70### EXP-001 — [name]
71- Hypothesis: We believe [outcome] if [who] [does what] because [reason]
72- Type: sprint / smoke test / concierge / painted door / A-B
73- Primary metric & threshold (pre-committed):
74- Guardrail metric:
75- Decision rule (pivot / persevere / iterate):
76- Result & verdict:
77 
78## Experiment Backlog
79| Idea | ICE (impact/confidence/ease) | Status |
80|---|---|---|
81```
82 
83## docs/ARCHITECTURE.md
84 
85```markdown
86# Architecture
87 
88## System Context
89What the system does, key integrations, load reality (back-of-envelope numbers).
90 
91## Layer Map & Dependency Rule
92Layers, what depends on what, current violations.
93| Violation | Location | Fix | Status |
94|---|---|---|---|
95 
96## Bounded Contexts & Context Map
97Contexts, relationships, anti-corruption layers.
98 
99## Domain Glossary (Ubiquitous Language)
100| Term | Meaning | Code name |
101|---|---|---|
102 
103## Data & Storage Decisions
104Data models, storage engines, isolation levels, replication, system-of-record vs derived data.
105 
106## Decision Log
107| Date | Decision | Why | Alternatives rejected |
108|---|---|---|---|
109```
110 
111## docs/TESTING.md
112 
113```markdown
114# Testing
115 
116## Test Strategy
117Pyramid, tooling, what "green" gates.
118 
119## Safety Net Map
120| Module | Pinned behaviors | Test files | Gaps |
121|---|---|---|---|
122 
123## Characterization Backlog
124- [ ] module (risk, priority)
125 
126## CI Gates
127```
128 
129## docs/DESIGN.md
130 
131```markdown
132# Design System
133 
134## Design Direction
135Signature moment, personality, references.
136 
137## Typography
138Typefaces, scale, measure, line height, loading strategy.
139 
140## Tokens
141Spacing scale · color palette (shades, tinted grays) · shadows.
142 
143## Components
144| Component | Decision | Status |
145|---|---|---|
146 
147## UX Audit Findings
148| Issue | Heuristic | Severity (0-4) | Fix | Status |
149|---|---|---|---|---|
150 
151## Microinteraction Inventory
152| Interaction | Trigger/Rules/Feedback/Loops | Fix | Status |
153|---|---|---|---|
154```
155 

Discussion

Alternatives