02 — Goal and Brief
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-directive is the prime directive (trumps generic 06-build); website-build-manifest is the acceptance index of every gate; website-build-doctrine is 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 4 Scout 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
AskUserQuestion ONLY 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
1---2name: goal-and-brief-23description: "Establish 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."4metadata:5 source: https://skillmd.com/skills/heymegabyte/goal-and-brief-26 version: "2.1.0"7 updated: "2026-05-03"8 effort: "medium"9 model: "haiku"10license: "Rutgers"11compatibility:12 claude-code: ">=2.0.0"13 agentskills: ">=1.0.0"14submodules:15priority: 216pack: "website-build"17stage: beta18triggers:19 - "new project"20 - "project brief"21 - "goals"22paths:23 - "org:website_build"24---2526# 02 — Goal and Brief2728Establish the project thesis and maintain `PROJECT_BRIEF.md` as the source of truth before any code is written.2930## Run FIRST on every new project / rebuild3132Before code, write `PROJECT_BRIEF.md`. The brief drives every downstream decision (skill 05 stack, skill 06 build, skill 09 brand, skill 16 site mode).3334> **One-line website prompt? Hand off after the brief**: `16-cinematic-website-prime-directive` is the prime directive (trumps generic 06-build); `website-build-manifest` is the acceptance index of every gate; `website-build-doctrine` is the Phase -1→8 sequence. Brief → manifest → doctrine → build.3536## Org-type inference (drives everything)3738Detect from domain + folder name + scraped homepage + Google Places category:3940| Pattern | Org type |41|---|---|42| `*.com` w/ pricing page + signup → | **saas** |43| `*.org` w/ donate button + 501(c)(3) → | **nonprofit** |44| Google Places category in {restaurant, salon, medical, legal, fitness, automotive, retail, photography, real-estate, education, financial, pet, wedding} → | **local-business** |45| `*.com` portfolio of links + bio + projects → | **portfolio** |46| `*.gov` / `.gov.uk` / `.ca.gov` → | **government** |47| `*.edu` / `*.ac.uk` → | **edu** |48| `*.church` / parish JSON-LD → | **church** |49| ProductHunt / G2 / Capterra listing → | **saas** |5051Output: `_org_type.json` = `{type, confidence, evidence[]}`.5253## PROJECT_BRIEF.md (source of truth)5455```md56# {Project Name}5758## Thesis59One sentence: what this project does + for whom + why now.6061## Org type62{saas | nonprofit | local-business | portfolio | edu | gov | church}6364## Primary user65- Persona: {role + context}66- Job to be done: {task they're trying to accomplish}67- Success metric: {what "done" looks like for them}6869## Business model70- Revenue: {subscription / donation / one-time / B2B / B2C / ads}71- Pricing: {tier list w/ values}72- Margins: {high / medium / low + rationale}7374## pSEO strategy (5 types)75- Integration pages (`/integrations/{tool}`) — Y/N76- Comparison (`/compare/{a}-vs-{b}`) — Y/N77- Use-case (`/for/{audience}`) — Y/N78- Template (`/templates/{type}`) — Y/N79- Location (`/{city}-{service}`) — Y/N8081## AI-native development approach82- AI-first features: {list}83- Workers AI / Llama 4 Scout for first-pass content84- Opus 4.8 for top-10 conversion polish85- AI vision QA on every visual surface8687## Constraints88- Budget89- Timeline90- Compliance (HIPAA / SOC 2 / GDPR / FERPA / ADA)91- Localization needs (`_kernel/standards.md` § ADA + `rules/i18n-by-demographics.md`)9293## Decision log94{Every architectural decision + rationale + alternatives considered}95```9697## Question discipline9899- Before code, scan brief for gaps. Use `AskUserQuestion` ONLY for genuinely unresolvable items (e.g., bilingual-staff confirmation, NAP verification, license number).100- Per `brian-preferences.md`: pick ONE answer when inferable, never offer options.101- Silence = approval.102103## What this skill produces104105- `PROJECT_BRIEF.md` — committed106- `_org_type.json` — input to skill 05 (stack) + skill 09 (brand) + skill 16 (site mode)107- `_brief_summary.txt` — 100-word digest for downstream agents