Next Site Method (NSM)

Build More Professional Websites — AI-driven agile framework for creating conversion-optimized websites and landing pages.

Follows BMAD METHOD architecture: specialized agents, structured workflows, configurableagents via TOML.

What is NSM?

Next Site Method is a framework where specialized AI agents guide you through website creation from strategy through launch:

1. Strategist → Define goals, audience, competitive position
2. Content Architect → Write persuasive copy and CTAs
3. Designer → Create design system (WCAG AA compliant)
4. SEO Specialist → Implement Schema.org and optimize
5. Developer → Build semantic HTML, CSS, JavaScript
6. Performance Engineer → Optimize Core Web Vitals
7. AI Specialist → Integrate AI agents/WebMCP
8. Compliance Officer → LGPD, privacy, legal compliance
9. QA Engineer → Test functionality, accessibility
10. Launch Manager → Deploy and monitor

Each agent is a skill you invoke in Claude Code. Each has a configurable menu and can be customized via customize.toml.

Quick Start

# Install NSM package
npm install website-method-nsm

Then in Claude Code:

/nsm-master-orchestrator    # Start the menu

Architecture

NSM follows BMAD METHOD structure:

src/nsm-skills/
├─ 1-strategy/
│  └─ nsm-agent-strategist/
│     ├─ SKILL.md         # Agent instructions
│     └─ customize.toml   # Menu, persona, config
├─ 2-content/
│  └─ nsm-agent-content-architect/
├─ 3-design/
│  └─ nsm-agent-designer/
├─ 4-seo/
│  └─ nsm-agent-seo-specialist/
├─ 5-develop/
│  └─ nsm-agent-developer/
├─ 6-optimize/
│  ├─ nsm-agent-performance-engineer/
│  ├─ nsm-agent-ai-specialist/
│  └─ nsm-agent-compliance-officer/
├─ 7-test/
│  └─ nsm-agent-qa-engineer/
└─ 8-launch/
   └─ nsm-agent-launch-manager/

Each agent:

• Has a SKILL.md with detailed instructions
• Has a customize.toml for configuration
• Can be customized per project without code changes
• Follows BMAD activation flow (persona, menu, dispatch)

How It Works

1. Create Website Brief

/nsm-agent-strategist

🎯 Strategist: Let's define your website strategy

[Menu]
DI - Conduct discovery interview
AB - Analyze existing business
TA - Define target audience
CP - Competitive positioning
CB - Create brief

> DI
[Strategist conducts structured interview]
[Produces: website-brief.md]

2. Write Content

/nsm-agent-content-architect

✍️ Content Architect: Ready to write your copy

[Menu]
WH - Write headlines
AB - About section
SV - Service descriptions
...

> WH
[Creates headlines based on brief]
[Shows for approval]
[Produces: website-content.md]

3. Design System

/nsm-agent-designer

🎨 Designer: Let's create your design system

[Presents color palette with WCAG verification]
[Produces: design-system.md + styles.css]

4-8. Continue Through Phases

Each phase builds on previous outputs. Agents read earlier phase files and extend them.

Customization

Each agent is customizable without code changes:

Project Overrides

Create _nsm/custom/{skill-name}.toml:

[agent]
icon = "🌟"  # Change icon
role = "Your custom role"  # Override role
identity = "Custom identity"  # Override identity

# Add to or replace menu items
[[agent.menu]]
code = "CUSTOM"
description = "My custom option"
skill = "my-custom-skill"

Or create {skill-name}.user.toml for personal overrides.

Complete Websites vs. Landing Pages

Complete Website (8 Phases)

Phases 1-8 in full sequence. Creates:

• Multi-page site structure
• Full content library
• Complete design system
• SEO optimization
• Performance optimization
• Compliance documentation
• Launch strategy

Time: 2-4 weeks depending on scope

Landing Page (4-5 Phases)

Phases 1, 2, 3, 5, 7 (skip SEO optimization, compliance):

• Single high-converting page
• Focused copy and design
• Performance optimized
• Quick deployment

Time: 1-2 weeks

Prerequisites

• Node.js 20+
• Claude Code IDE (or support for other IDEs coming)
• Basic understanding of: HTML, CSS, JavaScript
• Optional: Git for version control

Features

✅ 8 Specialized Agents — Each expert in their domain
✅ BMAD Architecture — Proven, extensible structure
✅ TOML Customization — Configure without coding
✅ Phase Gates — Approval required between phases
✅ Multi-Language — Auto-detects PT/EN/ES
✅ Accessibility First — WCAG AA compliance built-in
✅ Conversion Focused — Every element serves conversion goals
✅ Production Ready — Semantic HTML, CSS, vanilla JavaScript

Documentation

• AGENTS.md — Complete agent reference
• docs/tutorials/ — Step-by-step guides
• docs/reference/customize-reference.md — Customization guide
• src/nsm-skills/*/customize.toml — Agent configurations
• RESTRUCTURING.md — Why this architecture

Workflows

Create Complete Website

Strategist → Content Architect → Designer → 
SEO Specialist → Developer → 
(Parallel: Performance + AI + Compliance) → 
QA Engineer → Launch Manager

Create Landing Page

Strategist → Content Architect → Designer → 
Developer → QA Engineer → Launch Manager

Contributing

To extend NSM:

1. Create new skill in src/nsm-skills/{phase}/
2. Add SKILL.md + customize.toml
3. Update AGENTS.md reference
4. Submit PR

License

MIT — Free to use, modify, distribute

Status

🟢 Production Ready — NSM architecture complete

Next: Implementation of all skills and full documentation

Built by: Next Site Method Team
Based on: BMAD METHOD
Last Updated: 2026-05-02