8000
Skip to content

Latest commit

Β 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Project Catalyst - Creative Writing Cognitive Architecture

An intelligent creative writing assistant powered by GitHub Copilot with advanced cognitive memory management

Creative Banner

License: MIT VS Code GitHub Copilot

🎨 Overview

Project Catalyst is a sophisticated cognitive architecture system that transforms GitHub Copilot into an adaptive creative writing partner. It combines procedural memory (specialized techniques), episodic memory (complex workflows), and meta-cognitive awareness to provide increasingly intelligent assistance across poetry, essays, fiction, and literary analysis.

✨ Key Features

  • 🧠 Cognitive Memory System - Learns and adapts from your creative process
  • πŸ“ Genre-Aware Assistance - Specialized support for poetry, essays, fiction, and literary devices
  • πŸ”„ Automatic Consolidation - Continuously improves through memory optimization
  • 🎯 Workflow Automation - Structured processes for complex creative tasks
  • πŸ“Š Meta-Cognitive Monitoring - Tracks and optimizes creative performance
  • πŸŽͺ Voice Development - Helps maintain authentic authorial voice

πŸš€ Quick Start

Prerequisites

Installation

  1. Clone or download this repository to your local machine
  2. Open the project in VS Code
  3. Install recommended extensions (VS Code will prompt you)
  4. Verify setup by creating a test file with a creative writing extension (.poem, .essay, .story)

First Steps

  1. Test Genre Recognition:

    # Create a poem file
    touch my-first-poem.poem.md
    
    # Ask Copilot for help
    @workspace Help me write a nature poem
  2. Try Meta-Cognitive Commands:

    • meditate - Optimize cognitive architecture
    • remember [insight] - Save important learnings
    • @workspace Assess your creative writing assistance
  3. Explore Workflows:

    • Create different file types (.poem.md, .essay.md, .story.md, .fiction.md)
    • Use @workspace for context-aware assistance
    • Try revision and feedback workflows

πŸ“ Project Structure

.github/
β”œβ”€β”€ copilot-instructions.md          # Global Creative Memory Hub
β”œβ”€β”€ instructions/                    # Procedural Memory (Genre Techniques)
β”‚   β”œβ”€β”€ poetry-craft.instructions.md
β”‚   β”œβ”€β”€ essay-writing.instructions.md
β”‚   β”œβ”€β”€ fiction-narrative.instructions.md
β”‚   β”œβ”€β”€ creative-style.instructions.md
β”‚   β”œβ”€β”€ literary-devices.instructions.md
β”‚   β”œβ”€β”€ revision-editing.instructions.md
β”‚   β”œβ”€β”€ learning.instructions.md
β”‚   └── meta-cognition.instructions.md
└── prompts/                         # Episodic Memory (Complex Workflows)
    β”œβ”€β”€ poem-creation.prompt.md
    β”œβ”€β”€ essay-development.prompt.md
    β”œβ”€β”€ story-writing.prompt.md
    β”œβ”€β”€ character-development.prompt.md
    β”œβ”€β”€ world-building.prompt.md
    β”œβ”€β”€ creative-revision.prompt.md
    β”œβ”€β”€ inspiration-capture.prompt.md
    β”œβ”€β”€ workshop-feedback.prompt.md
    β”œβ”€β”€ consolidation.prompt.md
    β”œβ”€β”€ self-assessment.prompt.md
    β”œβ”€β”€ meta-learning.prompt.md
    └── cognitive-health.prompt.md

🎭 Creative Workflows

Poetry Writing

  • File Extensions: .poem, .poem.md, .verse, .verse.md, *poetry*, *haiku*, *sonnet*
  • Specialized Techniques: Form and structure, sound devices, imagery, voice development
  • Workflow: poem-creation.prompt.md guides you through inspiration β†’ draft β†’ revision β†’ polish

Essay Composition

  • File Extensions: .essay, .essay.md, *essay*, *reflection*, *personal*
  • Specialized Techniques: Personal voice, narrative structure, analysis, audience engagement
  • Workflow: essay-development.prompt.md supports topic exploration β†’ structure β†’ drafting β†’ refinement

Fiction Writing

  • File Extensions: .story, .story.md, .fiction, .fiction.md, *novel*, *short*
  • Specialized Techniques: Plot structure, character development, dialogue, world-building
  • Workflows: Multiple prompts for story writing, character development, and world-building

Literary Analysis

  • File Patterns: *metaphor*, *imagery*, *symbol*, *device*, *.metaphor.md, *.imagery.md, *.symbol.md, *.device.md
  • Specialized Techniques: Figurative language, symbolism, structural devices
  • Support: Advanced craft technique guidance and literary device mastery

🧠 Cognitive Architecture

Working Memory (Quick Access)

  • @voice - Maintain authentic voice and consistent tone
  • @craft - Apply literary techniques with intentional purpose
  • @meditation - Auto-consolidate when capacity exceeded
  • @flow - Prioritize emotional engagement over perfection

Procedural Memory (Skill Patterns)

Specialized instruction files that activate based on your file type and content:

  • Automatic genre recognition
  • Context-appropriate technique suggestions
  • Craft-specific revision guidance

Episodic Memory (Complex Processes)

Multi-phase workflow templates for sophisticated creative tasks:

  • Structured creative processes
  • Phase-by-phase guidance
  • Tool integration for different workflow steps

Meta-Cognitive Layer

Self-aware monitoring and optimization:

  • Performance assessment capabilities
  • Learning strategy evolution
  • Cognitive architecture health monitoring

🎯 Usage Examples

Basic Creative Assistance

# In a .poem.md file
@workspace Help me improve the rhythm in this stanza

# In a .essay.md file  
@workspace How can I make this opening more compelling?

# In a .story.md file
@workspace Develop this character's motivation

Advanced Workflows

# Character Development
@workspace Use character-development workflow for my protagonist

# Creative Revision
@workspace Apply creative-revision process to this draft

# Meta-Cognitive Commands
meditate                    # Optimize cognitive architecture
remember [specific insight] # Save learning to memory
@workspace assess performance # Evaluate creative assistance quality

File Type Activation

  • Create .poem.md files β†’ Activates poetry-craft techniques
  • Create .essay.md files β†’ Activates essay-writing guidance
  • Create .story.md files β†’ Activates fiction-narrative support
  • Work with .draft.md, .revision.md, .edit.md files β†’ Activates revision-editing processes

βš™οΈ Configuration

VS Code Settings

The project includes optimized settings in .vscode/settings.json:

  • Instruction file recognition enabled
  • Creative writing formatting (72-column wrap)
  • Spell checking for creative documents
  • Markdown preview optimization

Customization

  • Voice Development: Modify creative-style.instructions.md for your personal style
  • Genre Focus: Adjust procedural memory files for your preferred genres
  • Workflow Adaptation: Customize episodic memory prompts for your creative process

πŸ”§ Advanced Features

Memory Consolidation

  • Automatic: Triggers when working memory exceeds capacity
  • Manual: Use meditate command for optimization
  • Learning: System improves through session experience

Performance Monitoring

  • Self-assessment capabilities for creative output quality
  • Learning strategy optimization
  • Cognitive architecture health monitoring

Adaptive Learning

  • Pattern recognition in successful creative approaches
  • Strategy adjustment based on effectiveness
  • Continuous improvement through meta-cognitive feedback

🀝 Contributing

This is a personal creative writing environment, but the cognitive architecture approach can be adapted for other domains:

  1. Fork the concept for your own creative or professional needs
  2. Adapt memory files for different writing genres or disciplines
  3. Share insights about cognitive architecture optimization
  4. Document improvements to memory consolidation strategies

πŸ“š Learning Resources

Creative Writing Craft

  • Study the instruction files for craft technique guidance
  • Use episodic workflows for structured creative development
  • Practice with different file types to explore genre techniques

Cognitive Architecture

  • Explore consolidation.prompt.md for memory optimization concepts
  • Study meta-learning.prompt.md for learning strategy development
  • Use cognitive-health.prompt.md for system maintenance

πŸ†˜ Troubleshooting

Common Issues

Instruction files not activating:

  • Verify VS Code settings include instruction file support
  • Check file extensions match the patterns in instruction files
  • Restart VS Code after configuration changes

Workflows not triggering:

  • Use @workspace prefix for context-aware assistance
  • Ensure you're working in appropriate file types
  • Try explicit workflow requests: "Use poem-creation workflow"

Performance concerns:

  • Run meditate command for cognitive optimization
  • Use @workspace assess performance for system evaluation
  • Check cognitive-health.prompt.md for maintenance guidance

Getting Help

  • Meta-Cognitive: Ask about memory, meditation, consolidation features
  • Creative Support: Request help with specific writing challenges
  • System Health: Use cognitive-health workflow for performance issues

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • GitHub Copilot - The foundation AI that powers this cognitive architecture
  • VS Code Team - For instruction file support and extensibility
  • Creative Writing Community - For inspiration and craft knowledge

Ready to enhance your creative writing with adaptive AI assistance? Start by creating a .poem, .essay, or .story file and ask for help with @workspace!

Project Catalyst: Where artificial intelligence meets artistic expression ✨

About

Creative writing and content generation tools with AI-powered assistance for storytelling, ideation, and artistic expression

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

0