⚡ Pew Pew Workspace 🏗️

AI-powered project management framework based on an opinionated view on effective prompts and a highly modular approach to building effective agents, workflows, templates, prompts and context documents.

🚀 Quick Start

Add the latest files of the Pew Pew framework to any existing project with a single command:

curl -fsSL https://raw.githubusercontent.com/pew-pew-prompts/pew-pew-workspace/main/.pew/install.sh | bash

This wi ll:

1. Download all framework components into .pew/ subdirectories
2. Preserve your existing project files
3. Add the .claude/ directory with all synced artifacts
4. Enable all /plx: commands in your project

After Installation: Sync Anytime

Once installed, sync all docs from your project root with:

make -f .pew/Makefile sync claude

Or directly:

./.pew/scripts/claude-code/sync-claude-code.sh

Configuration (.pew/plx.yaml)

The sync process uses .pew/plx.yaml as the main configuration:

• .pew/plx.yaml: Main configuration file (committed, uses .pew/ subdirectories)
• .pew/plx.local.yaml: Optional local override (never committed, for personal customizations)

Customize sync behavior in .pew/plx.yaml:

• sync_sources: Which directories to sync from
• sync_targets: Where to sync files to
• delete_before_sync_targets: Directories to clean before syncing
• delete_after_sync_targets: Directories to clean after syncing

Local Override: Create .pew/plx.local.yaml to override settings without modifying the main config. This file is gitignored and perfect for personal customizations.

✨ What's New in v0.8.0

🚀 Raycast Power Prompter Framework

• Comprehensive Freelancer Toolkit: New 00-freelancers/raycast-power-prompter/ directory with:
  • 20+ reusable blocks for requirements, analytics, components, user stories
  • Extensive Flutter development instructions (concepts, patterns, best practices)
  • Universal refinement prompts with strategic questioning methodology
  • Export/import system for Raycast snippet management
  • Templates for events, meetings, milestones, and development plans

🛠️ Enhanced Template System

• Integrated Agent Instructions: Plan templates now include comprehensive agent instructions
• Universal Refinement Mode: Systematically refine ANY template through strategic questioning
• File Reference Conventions: Proper @[relative/path] format for file references

✨ New Features & Improvements

• Pew Prompt: Ultimate starting point for any task in any project
• GitHub Release Workflow: Comprehensive documentation validation and release creation
• Activity System: Reusable actions organized by concept categories
• Scope Integrity: Prevents AI over-engineering by ensuring exact requirement delivery

🔧 Architecture Enhancements

• Collections System: Curated lists for Flutter concepts and instructions
• Single-Verb Prompt Routing: YAML configuration for separate routing patterns
• Dynamic Project Key Detection: Automatic detection from commit history

📝 A Good Prompt

The foundation of this framework is understanding what makes an effective prompt. Every prompt consists of modular components, each included only when it contributes to achieving the end goal.