Understanding Your Documents
Norvo generates a comprehensive documentation bundle for every project — 13 structured Markdown documents plus synthetic configuration files for AI coding assistants. Here is what each one contains and how they work together.
Project Documentation
Every generation produces these 13 documents. Together, they form a complete blueprint that any developer or AI coding assistant can use to start building immediately.
Product Overview
High-level summary of what the project is, who it's for, and what problem it solves. This is the starting point for anyone new to the project — it sets the stage for every other document in the bundle.
Goals and Success Metrics
Measurable objectives and key results that define what success looks like for the project. Use this to align your team around concrete milestones and track progress against real metrics.
Product Requirements
Detailed functional and non-functional requirements broken down by feature area. This document gives developers and AI assistants a clear, unambiguous picture of exactly what needs to be built.
Technology Stack
Recommended technologies, frameworks, and tools with justifications for each choice. Every recommendation is tailored to your project's constraints, scale, and team experience.
System Architecture
System design including component diagrams, service boundaries, and communication patterns. This document maps out how the pieces of your application fit together at a structural level.
Database Schema
Data models, entity relationships, table definitions, and indexing strategies. A ready-to-implement schema that reflects the requirements and architecture decisions from other documents.
API Specification
Endpoint definitions, request/response formats, authentication flows, and error handling. This gives frontend developers and external integrators everything they need to work against your API.
Folder Structure
Recommended project directory layout with explanations for each directory's purpose. Drop this into your repo and you have an organized, scalable codebase from day one.
Development Phases
Step-by-step implementation roadmap broken into milestones with dependencies. This turns your project from an overwhelming monolith into a series of achievable, ordered tasks.
Deployment Guide
Infrastructure setup, CI/CD pipeline configuration, environment management, and scaling considerations. Everything you need to go from local development to production with confidence.
Testing Strategy
Testing strategy covering unit, integration, and end-to-end tests with recommended tools and patterns. A practical guide that ensures your code is reliable and regressions are caught early.
Security Hardening
Security considerations including authentication, authorization, data protection, and common vulnerability mitigations. This document helps you build secure software from the start rather than bolting it on later.
Observability Strategy
Logging, monitoring, alerting, and debugging strategies for production environments. When something goes wrong at 2 AM, this document ensures you have the visibility to find and fix it fast.
Synthetic Configuration Files
When enabled on your plan, Norvo also generates AI assistant configuration files tailored to your project. These files summarize your architecture, conventions, and key decisions in the format each tool expects. Drop them in your repo root and your AI assistant immediately understands your project.
CLAUDE.md
Project context file for Claude Code and Claude AI assistants. Contains your architecture decisions, coding conventions, and key patterns in the format Claude expects.
.cursor/rules/project-rules.mdc
Configuration file for the Cursor AI code editor. Encodes your project's style guide, preferred patterns, and domain context so Cursor generates code that fits your codebase.
.claude/commands/*.md
Claude Code slash commands for common workflows — adding features, fixing bugs, writing tests, and reviewing code. Run them directly from your terminal.
.agents/skills/*/SKILL.md
Agent skill definitions for task implementation, feature development, debugging, testing, PR review, and refactoring. Gives AI agents structured workflows for complex tasks.
How Documents Connect
Norvo documents are not generated in isolation. Every document cross-references the others to form a coherent, internally consistent project plan.
The Architecture document references your Tech Stack choices and reflects the service boundaries implied by your Product Requirements.
The API Specification aligns with the Database Schema — every endpoint operates on the models your schema defines.
Development Phases reference all technical documents, ordering tasks so that foundational work like database setup and auth comes before feature implementation.
Testing and Security strategies are informed by the architecture and API surface, ensuring coverage maps to what you are actually building.
Synthetic config files distill decisions from across all 13 documents into the compact format each AI tool needs, so your assistant always has the full picture.
Ready to explore more?
Head back to the documentation hub or learn how to export and use your generated documents.