The methodology site for planning and executing complex software work with AI coding agents.
deepworkplan.com is the official website for the Deep Work Plan (DWP) methodology — a structured, agent-agnostic approach to executing complex, multi-step software work reliably with AI coding agents.
The site is a fast, fully bilingual (English + Spanish) static site built with Astro. It explains and sells the methodology, hosts the readable specification, and catalogs the kit (presets, adapters, commands) for installing DWP into any repository. The repository dogfoods the methodology it documents.
The tone is serious, neutral, and technical — this is a specification-and-methodology site, not a personal blog.
The repository practices the methodology it documents. The official DeepWorkPlan skill is installed under .agents/skills/deepworkplan/ as a reference install — the skill source is gitignored, and a committed skills-lock.json pins it. What is committed is the thin dwp-* command delegators, the /skill-create and /agent-create delegators (which route to the skill's author sub-skill that grows the repo's own kit), the /lib-upgrade delegator for the opt-in dependency-upgrade add-on, and the /init adoption flow. All Deep Work Plan output lives in the gitignored .dwp/ directory. The legacy homegrown command engine has been retired in favor of the installed skill. See docs/ARCHITECTURE.md for details.
| Feature | Description |
|---|---|
| 📚 Methodology reader | The DWP methodology, principles, and adoption workflow |
| 📐 Specification reader | The normative DWP standard: task anatomy, validation gates, archetypes |
| 🧰 Kit catalog | Presets, adapters, and commands for installing DWP into a repo |
| 🌐 Bilingual | Full English & Spanish with route parity |
| 🌙 Dark mode | System-aware theme toggle with persistence |
| ⚡ Performance-first | Static site, minimal JS, optimized assets, 90+ Lighthouse |
| 🔍 SEO + AEO | Sitemap, Open Graph, structured data, agent-friendly Markdown endpoints |
| 🤖 Agent-friendly | Shared .agents/ home for skills, commands, and agent definitions across Claude Code, Codex, Cursor, Gemini |
Note: The blog engine (MDX posts, series, multi-author, tag taxonomy, RSS, search) is fully built but kept dormant — hidden from navigation and reserved for future case studies about applying the methodology. Slides/tech-talks and personal pages have been removed.
| Layer | Technology |
|---|---|
| Framework | Astro 5.x |
| UI | Svelte 5.x |
| Styling | Tailwind CSS 4.x |
| Language | TypeScript 5.x |
| Linting | Biome 2.x |
| Testing | Vitest + Testing Library |
| Content | Markdown, MDX |
| Edge | Cloudflare Pages Functions (bot analytics middleware) |
| Hosting | Cloudflare Pages |
Requires Node.js 24+ (CI runs on 24.15.0). The package manager is pnpm, pinned via Corepack in
package.json#packageManager. Enable it once withcorepack enable; the dev container does this automatically.
corepack enable
pnpm install
pnpm run devVisit http://localhost:5555 to preview.
| Command | Description |
|---|---|
pnpm run dev |
Start dev server at localhost:5555 |
pnpm run build |
Production build with type check |
pnpm run astro:preview |
Preview production build locally |
pnpm run biome:check |
Lint and format check |
pnpm run biome:fix |
Auto-fix lint and format issues |
pnpm run astro:check |
TypeScript type checking |
pnpm run test |
Run unit tests (Vitest) |
pnpm run test:watch |
Vitest in watch mode |
pnpm run test:coverage |
Tests with coverage report |
pnpm run images:optimize |
Convert staged images to WebP |
pnpm run md:check |
Verify HTML / Markdown agent-endpoint parity |
pnpm run search:budgets |
Check search index performance budgets |
pnpm run lighthouse |
Run Lighthouse CI audit |
pnpm run ncu:check |
Check for dependency updates |
pnpm run release |
Bump version and create release commit |
├── public/ # Static assets (images, fonts, icons, robots.txt)
├── src/
│ ├── components/ # Astro & Svelte components
│ ├── content/ # Content Collections
│ │ ├── methodology/ # Methodology docs by language (en/, es/) — primary content
│ │ ├── spec/ # Specification reader content (en/, es/)
│ │ ├── kit/ # Kit catalog: presets, adapters, commands (en/, es/)
│ │ ├── pages/ # Agent-friendly Markdown endpoints (en/, es/)
│ │ ├── authors/ # Author definitions (.yaml) — used by dormant blog
│ │ ├── blog/ # Blog posts by language (en/, es/) — DORMANT engine
│ │ ├── series/ # Blog series definitions — DORMANT engine
│ │ └── tags/ # Tag taxonomy with tiers — DORMANT engine
│ ├── layouts/ # MainLayout, InternalLayout, ...
│ ├── lib/ # Utilities, types, translations
│ ├── pages/ # File-based routing (EN root, ES in /es/)
│ ├── middleware.ts # Route allowlist & rewrites
│ └── styles/ # Global CSS (Tailwind 4)
├── functions/ # Cloudflare Pages Functions (edge middleware)
├── tests/ # Vitest unit & integration tests
├── scripts/ # Build utilities (image optimization, parity checks)
├── docs/ # Project documentation
├── .agents/ # Cross-agent skills, commands, agent definitions
├── .claude → .agents # Backward-compat symlink for Claude Code
├── assets/ # README and documentation assets
└── astro.config.mjs
| Document | Description |
|---|---|
| Product Spec | Vision, audience, features, and content strategy |
| Architecture | Technical implementation and patterns |
| Development Commands | Build scripts and workflows |
| Standards | Coding conventions |
| I18N Guide | Multilingual content and translations |
| Testing | Vitest setup and test conventions |
| Performance | Astro SSG optimization and budgets |
| Accessibility | WCAG AA standards and patterns |
| SEO | Meta, structured data, multilingual, AEO |
| Security | Security best practices |
| AI Agent Onboarding | Setup for AI coding assistants |
| Skills & Agents Catalog | Available skills and agents |
| Blog Posts (dormant) | Blog engine reference, reserved for future case studies |
Deployed to Cloudflare Pages on every push to main:
- Cloudflare triggers a build
- Runs
pnpm run build(WebP generation + Astro build) - Serves the
dist/folder from its global CDN
Live at deepworkplan.com.
MIT — Dailybot, Inc.
- Icons: Heroicons, Simple Icons
🔌 Powered by Dailybot
Dailybot is an AI-powered async communication platform that keeps people and agents visible — without adding more meetings or tools. It lives where your team already works (Slack, Teams, Google Chat, Discord, VS Code, and the CLI) and turns scattered signals into clear progress: async check-ins and standups, AI summaries that detect blockers and read team sentiment, workflow automation and approvals, team analytics, and recognition. As AI agents join the workflow, Dailybot surfaces their status and activity right alongside your team's — so long-running agents never go dark. Learn more.