north-star

Create, review, or update NORTH-STAR.md to anchor product vision and architectural decisions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dlepaux/dotfiles --skill north-star-dlepaux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: north-star
Source: https://github.com/dlepaux/dotfiles/tree/main/.claude/skills/north-star
Command: npx skills add https://github.com/dlepaux/dotfiles --skill north-star-dlepaux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

NORTH-STAR.md acts as the central authority for product vision and architectural direction, ensuring all work is guided by a single, coherent objective.

Core Features & Use Cases

  • Create NORTH-STAR.md when starting a project or major initiative to establish a shared vision.
  • Review and validate alignment between the codebase, roadmap, and goals, and update the document as needed.
  • Generate a concise alignment narrative for stakeholders and teams to reference during planning and reviews.

Quick Start

Provide project context and goals to let this skill generate or update NORTH-STAR.md at the project root.

Frequently Asked Questions about north-star

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I align my codebase with product vision and roadmap goals?

A NORTH-STAR.md document anchors product vision and architectural decisions by acting as a central authority for project goals. It ensures all work across multiple teams is guided by a single, coherent objective during kickoffs, pivots, or regular alignment reviews.

What is the best way to document project vision for multiple teams?

Documenting project vision for multiple teams is best done by generating a NORTH-STAR.md file at the project root. This provides a shared reference point that anchors evolving goals and shifting constraints, ensuring coherent architectural decisions across all teams.

How do I create a NORTH-STAR.md file for project alignment?

You create a NORTH-STAR.md file by providing your project context and goals to this skill, which then generates the document at the project root. It includes update prompts and guiding questions to help establish a shared vision for stakeholders and teams.

Can I review existing roadmap alignment without rewriting my entire vision document?

Yes, you can review existing roadmap alignment without a full rewrite because this skill detects an existing NORTH-STAR.md file and analyzes codebase alignment. It generates a concise alignment narrative and provides update prompts to adjust only what is needed.

Does this product vision alignment approach work for projects with shifting constraints?

This product vision alignment approach works specifically well for projects with shifting constraints, evolving goals, and multiple teams. It anchors architectural decisions during major pivots or regular alignment reviews to maintain a coherent objective.