02 — Goal and Brief
SkillAI & modelsEstablish project thesis before first code. Infer product type from domain/folder/README. Identify users, business model, pSEO strategy, AI-native dev approach. Maintain PROJECT_BRIEF.md as source of truth.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the 02 — Goal and Brief skill
What this skill tells your AI
The instructions your AI receives, as published by heymegabyte/claude-skills in 02-goal-and-brief/SKILL.md and read by ahel’s review.
Establish the project thesis and maintain PROJECT_BRIEF.md as the source of truth before any code is written.
Run FIRST on every new project / rebuild
Before code, write PROJECT_BRIEF.md. The brief drives every downstream decision (skill 05 stack, skill 06 build, skill 09 brand, skill 16 site mode).
One-line website prompt? Hand off after the brief:
16-cinematic-website-prime-directiveis the prime directive (trumps generic 06-build);website-build-manifestis the acceptance index of every gate;website-build-doctrineis the Phase -1→8 sequence. Brief → manifest → doctrine → build.
Org-type inference (drives everything)
Detect from domain + folder name + scraped homepage + Google Places category:
| Pattern | Org type |
|---|---|
*.com w/ pricing page + signup → | saas |
*.org w/ donate button + 501(c)(3) → | nonprofit |
| Google Places category in {restaurant, salon, medical, legal, fitness, automotive, retail, photography, real-estate, education, financial, pet, wedding} → | local-business |
*.com portfolio of links + bio + projects → | portfolio |
*.gov / .gov.uk / .ca.gov → | government |
*.edu / *.ac.uk → | edu |
*.church / parish JSON-LD → | church |
| ProductHunt / G2 / Capterra listing → | saas |
Output: _org_type.json = {type, confidence, evidence[]}.
PROJECT_BRIEF.md (source of truth)
# {Project Name}
## Thesis
One sentence: what this project does + for whom + why now.
## Org type
{saas | nonprofit | local-business | portfolio | edu | gov | church}
## Primary user
- Persona: {role + context}
- Job to be done: {task they're trying to accomplish}
- Success metric: {what "done" looks like for them}
## Business model
- Revenue: {subscription / donation / one-time / B2B / B2C / ads}
- Pricing: {tier list w/ values}
- Margins: {high / medium / low + rationale}
## pSEO strategy (5 types)
- Integration pages (`/integrations/{tool}`) — Y/N
- Comparison (`/compare/{a}-vs-{b}`) — Y/N
- Use-case (`/for/{audience}`) — Y/N
- Template (`/templates/{type}`) — Y/N
- Location (`/{city}-{service}`) — Y/N
## AI-native development approach
- AI-first features: {list}
- Workers AI / Llama 3.3 for first-pass content
- Opus 4.8 for top-10 conversion polish
- AI vision QA on every visual surface
## Constraints
- Budget
- Timeline
- Compliance (HIPAA / SOC 2 / GDPR / FERPA / ADA)
- Localization needs (`_kernel/standards.md` § ADA + `rules/i18n-by-demographics.md`)
## Decision log
{Every architectural decision + rationale + alternatives considered}
Question discipline
- Before code, scan brief for gaps. Use
AskUserQuestionONLY for genuinely unresolvable items (e.g., bilingual-staff confirmation, NAP verification, license number). - Per
brian-preferences.md: pick ONE answer when inferable, never offer options. - Silence = approval.
What this skill produces
PROJECT_BRIEF.md— committed_org_type.json— input to skill 05 (stack) + skill 09 (brand) + skill 16 (site mode)_brief_summary.txt— 100-word digest for downstream agents
Signals
- GitHub stars
- 21
- Forks
- 4
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
goal-and-brief- Source
- github.com/heymegabyte/claude-skills