Package Exports

wdks
wdks/tools/wdks-npx-wrapper.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (wdks) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

WD-KS (Write Development Knowledge System)

AI-Assisted Writing Framework for Fiction Development

WD-KS is a modular knowledge system that provides AI agents and structured workflows to assist writers throughout the entire creative fiction writing process—from initial brainstorming through final manuscript.

✨ Features

18 Specialized AI Agents organized into 3 teams
16 Structured Workflows covering the complete writing process
4 Development Phases: Ideation → Architecture → Writing → Revision
Modular Architecture for easy customization and extension
Project Memory via sidecar files for persistent context
IDE Integration support for Cursor, Windsurf, and VS Code

📦 Installation

Quick Start (NPX)

# In your writing project directory
npx wdks install

# Or with a local clone
cd your-project
node /path/to/wd-ks/tools/wdks-npx-wrapper.js install

Manual Installation

# Clone the repository
git clone https://github.com/muriloms/wd-ks.git

# Install dependencies
cd wd-ks
npm install

# Install in a project
cd ../your-writing-project
node ../wd-ks/tools/wdks-npx-wrapper.js install

🏗️ Project Structure After Installation

your-project/
├── _wdks/                    # WD-KS installation
│   ├── core/                 # Core module
│   │   ├── agents/           # Master agent
│   │   └── workflows/        # Core workflows
│   ├── wdm/                  # Write Development Module
│   │   ├── agents/           # 17 specialized agents
│   │   └── workflows/        # 14 writing workflows
│   ├── compiled/             # Compiled agent prompts (.md)
│   └── _memory/              # Sidecar files (agent memory)
├── docs/                     # Project documentation
│   ├── bible/                # Story Bible
│   ├── characters/           # Character profiles
│   ├── world/                # World documentation
│   ├── timeline/             # Chronology
│   ├── structure/            # Chapter outlines
│   └── vision/               # Creative vision
├── manuscript/               # Written content
│   ├── chapters/             # Chapter drafts
│   └── annotations/          # Chapter notes
├── references/               # Reference materials
│   └── authors/              # Author influence notes
├── project-config.yaml       # Project configuration
└── workflow-status.yaml      # Workflow progress tracking

🤖 Agent Teams

Team Ideation (Phase 1)

Creative exploration and concept development.

Agent	Icon	Role
Ideation Facilitator	💡	Team Lead - Brainstorming and concept development
Genre Expert	📚	Genre conventions and reader expectations
Reference Analyst	🔬	Influence analysis and technique extraction
Concept Critic	🔍	Constructive concept stress-testing
Vision Synthesizer	✨	Vision consolidation and phase transition

Team Architecture (Phase 2)

Story structure and comprehensive planning.

Agent	Icon	Role
Story Architect	🏛️	Team Lead - Story structure and Story Bible
World Builder	🌍	Setting and world development
Character Designer	👤	Character psychology and development
Timeline Keeper	⏳	Chronology and continuity
Style Director	🎨	Prose style and voice definition
Series Planner	📚	Multi-book and series planning

Team Writing (Phases 3-4)

Prose writing and refinement.

Agent	Icon	Role
Story Writer	✍️	Team Lead - Prose writing and chapter development
Continuity Checker	🔎	Consistency verification and error detection
Style Guardian	🛡️	Style consistency during writing
Chapter Annotator	📝	Chapter documentation and revision tracking
Scene Coordinator	🎬	Scene structure and chapter flow
Dialogue Specialist	💬	Dialogue craft and character voice

📋 Workflows

Phase 1: Ideation

Workflow	Lead Agent	Trigger	Description
brainstorm-story	Ideation Facilitator	`*brainstorm`	Structured brainstorming session
explore-genre	Genre Expert	`*explore-genre`	Deep dive into genre conventions
analyze-references	Reference Analyst	`*analyze`	Study influences and techniques
create-vision	Vision Synthesizer	`*create-vision`	Consolidate creative vision

Phase 2: Architecture

Workflow	Lead Agent	Trigger	Description
create-story-bible	Story Architect	`*story-bible`	Create master reference document
build-world	World Builder	`*build-world`	Comprehensive world-building
create-character	Character Designer	`*create-character`	Deep character development
map-timeline	Timeline Keeper	`*map-timeline`	Create chronology
define-style-guide	Style Director	`*style-guide`	Establish prose style
structure-book	Story Architect	`*structure`	Chapter-by-chapter planning

Phase 3-4: Writing & Revision

Workflow	Lead Agent	Trigger	Description
write-chapter	Story Writer	`*write-chapter`	Guided chapter writing
check-consistency	Continuity Checker	`*check-consistency`	Continuity and consistency check
review-style	Style Guardian	`*review-style`	Style review and polish
annotate-chapter	Chapter Annotator	`*annotate`	Chapter documentation

🚀 Usage

Starting a Project

Install WD-KS in your project directory
Begin with Ideation: Type *brainstorm to start
Follow the workflow: Each workflow guides you through steps
Navigate between agents: Use *agent-name triggers

Quick Commands

*master          → Return to WD-KS Master
*status          → Check workflow status
*brainstorm      → Start brainstorming
*story-bible     → Create Story Bible
*write-chapter   → Begin chapter writing

Typical Flow

IDEATION
*brainstorm → *explore-genre → *analyze → *create-vision
                              ↓
ARCHITECTURE
*story-bible → *build-world → *create-character → *map-timeline → *style-guide → *structure
                              ↓
WRITING
*write-chapter → *check-consistency → *review-style → *annotate
                              ↓
                    COMPLETED MANUSCRIPT

📁 CLI Commands

# Install WD-KS in a project
wdks install

# Check installation status
wdks status

# List available agents and workflows
wdks list

# Compile agents to markdown
wdks compile

🔧 Configuration

project-config.yaml

project:
  name: "My Novel"
  type: novel
  genre: fantasy
  
settings:
  collaboration:
    handoff_style: suggestion
    show_suggestions: true

Customizing Agents

Agent behavior can be customized by editing the compiled .md files in _wdks/compiled/.

📚 Documentation

🛠️ Development

Running Tests

npm test                    # All tests
npm run test:schemas        # Schema validation
npm run test:compiler       # Compiler tests
npm run test:installer      # Installer tests

Validating Schemas

npm run validate:schemas

Project Structure

wd-ks/
├── src/
│   ├── core/              # Core module
│   │   ├── agents/        # wdks-master
│   │   └── workflows/     # Core workflows
│   └── modules/
│       └── wdm/           # Write Development Module
│           ├── agents/    # 17 agents
│           └── workflows/ # 14 workflows
├── tools/
│   ├── cli/               # CLI implementation
│   └── schema/            # Zod schemas
└── test/                  # Test files

📄 License

MIT License - see LICENSE for details.

🤝 Contributing

Contributions welcome! Please read our contributing guidelines before submitting PRs.

WD-KS - Empowering writers with AI-assisted creative development.