Skip to content

Latest commit

 

History

History
623 lines (361 loc) · 4.73 KB

File metadata and controls

623 lines (361 loc) · 4.73 KB

PRODUCT_SPEC.md

Version 3.0

PRODUCT

REPL Works Website


PRODUCT_TYPE

Documentation Platform

Purpose:

Introduce

Teach

Distribute

Standardize

REPL Works

PRODUCT_MISSION

Establish REPL Works as an AI-Native Product Development Framework.


REPL Works provides:

Workflow

Prompts

Documents

Tools

Showcase

The website exists to help visitors:

Understand REPL Works

Adopt REPL Works

Apply REPL Works

Build REPL Works Compatible Products

TARGET_AUDIENCE

Primary

Solo Founders

Indie Hackers

AI-Native Builders

Secondary

Startups

Small Teams

Technical Product Builders

CORE_MESSAGE

AI can generate code.

Projects require structure.

AI can execute tasks.

Projects require continuity.

Models change.

Projects survive.

VALUE_PROPOSITION

REPL Works provides:

A repeatable workflow

Reusable prompts

Reusable documents

Reusable tools

Real-world examples

for AI-native product development.


INFORMATION_ARCHITECTURE

Home

Workflow

Prompts

Documents

Tools

Showcase

FAQ

GitHub

PRIMARY_USER_JOURNEY

Home
↓
Workflow
↓
Prompts
↓
Documents
↓
Tools
↓
Showcase
↓
GitHub

HOME

Purpose

Explain REPL Works

Explain Why It Exists

Drive Adoption

Must answer:

What is REPL Works?

Why does it matter?

How does it work?

Where do I start?

WORKFLOW

Purpose

Explain the REPL Works methodology

Must describe:

Idea Validation

Product Definition

Architecture Design

Task Planning

AI Execution

Review

Release

Continuous Improvement

Must explain:

Discussion AI

Execution AI

Human Review

PROMPTS

Purpose

Provide reusable prompts

Prompt Categories

Idea Refinement

Pitch Generation

Product Specification

Architecture Generation

Task Generation

Execution Validation

Architecture Review

Task Review

Visitors must be able to:

Read

Copy

Reuse

prompts directly.


DOCUMENTS

Purpose

Provide reusable document standards

Required Documents

AGENTS.md

PRODUCT_SPEC.md

ARCHITECTURE.md

TASKS.md

Optional Documents

IDEAS.md

PITCHING_SCRIPT.md

Each document page must explain:

Purpose

Responsibility

Creation Timing

Update Rules

TOOLS

Purpose

Provide tooling for REPL Works

Initial Tools

ai-issue

Future Tools

ai-prompt

Additional REPL Works Tooling

Each tool page must include:

Purpose

Installation

Usage

Repository Link

SHOWCASE

Purpose

Demonstrate real adoption

Showcase entries must be real projects.


Initial Entries

REPL Works Website

ai-issue

Wifi Note

Each entry should explain:

Project

Purpose

Workflow Usage

Documents Used

Tools Used

REPL_WORKS_COMPATIBLE

Showcase entries may be designated:

REPL Works Compatible

Definition

Project follows the REPL Works workflow.

Project uses REPL Works documents.

Project is maintained using REPL Works principles.

Purpose

Demonstrate adoption

Create ecosystem visibility

Encourage standardization

FAQ

Purpose

Answer recurring questions

Examples

What is REPL Works?

Why use AI and documents together?

Why separate planning from execution?

Why Git First?

What makes a project compatible?

GITHUB

GitHub is the primary external asset.


Website explains:

Workflow

Prompts

Documents

Tools

GitHub stores:

Source Code

Issues

Pull Requests

Releases

Website must never replace GitHub.


CONTENT_STRATEGY

Content First

Design Second


Priority Order

Workflow

Prompts

Documents

Tools

Showcase

Design exists to improve content discoverability.


SUCCESS_CRITERIA

Visitors can:

Understand REPL Works

Use REPL Works

Download Documents

Copy Prompts

Install Tools

Explore Compatible Projects

LONG_TERM_VISION

Create an ecosystem where:

Workflow

Prompts

Documents

Tools

become reusable standards for AI-native product development.


Desired Outcome

Built with REPL Works

becomes a recognizable signal of structured AI-native development.


FINAL

REPL Works is an AI-Native Product Development Framework.

The website exists to distribute:

Workflow

Prompts

Documents

Tools

and showcase real-world adoption through REPL Works Compatible projects.