@mytechtoday/augment-extensions 0.2.0 → 0.4.0

package/augment-extensions/workflows/database/rules/workflow.md

@@ -0,0 +1,458 @@
+# Database Design and Development Workflow
+
+## Overview
+
+This workflow provides comprehensive guidance for AI agents working on database-related tasks, from initial database selection through schema design, implementation, migration, optimization, and testing.
+
+## Core Workflow
+
+```
+┌─────────────────────┐
+│ Database Selection  │
+│ Choose DB type      │
+└──────────┬──────────┘
+           │
+           ▼
+┌─────────────────────┐
+│ Schema Design       │
+│ Model entities      │
+└──────────┬──────────┘
+           │
+           ▼
+┌─────────────────────┐
+│ Implementation      │
+│ Create schema       │
+└──────────┬──────────┘
+           │
+           ▼
+┌─────────────────────┐
+│ Migration           │
+│ Version changes     │
+└──────────┬──────────┘
+           │
+           ▼
+┌─────────────────────┐
+│ Optimization        │
+│ Tune performance    │
+└──────────┬──────────┘
+           │
+           ▼
+┌─────────────────────┐
+│ Testing             │
+│ Validate behavior   │
+└─────────────────────┘
+```
+
+## Coordination with OpenSpec and Beads
+
+Database work should be tracked using OpenSpec specifications and Beads tasks:
+
+**OpenSpec Integration**:
+- Create specs in `openspec/specs/database/`
+- Document schema requirements and design decisions
+- Track breaking changes and migration strategies
+
+**Beads Integration**:
+- Create tasks with `bd create "Task description"`
+- Reference specs: `"spec": "database/schema-design"`
+- Track dependencies between schema changes
+
+**Example Task**:
+```json
+{
+  "id": "bd-db01",
+  "title": "Design user authentication schema",
+  "spec": "database/user-auth-schema",
+  "rules": ["schema-design-workflow.md"],
+  "status": "open",
+  "priority": 0
+}
+```
+
+## Workflow Steps
+
+### Step 1: Database Selection
+
+**Purpose**: Choose the right database type for your use case
+
+**Decision Framework**:
+
+1. **Analyze Data Structure**:
+   - Structured (tables, rows) → Relational (PostgreSQL, MySQL)
+   - Semi-structured (documents) → NoSQL (MongoDB, DynamoDB)
+   - Graph relationships → Graph DB (Neo4j, ArangoDB)
+   - Vector embeddings → Vector DB (Pinecone, Milvus)
+   - Simple key-value → Redis, DynamoDB
+   - Flat files → CSV, JSON
+
+2. **Analyze Query Patterns**:
+   - Complex joins and aggregations → Relational
+   - Document retrieval → NoSQL
+   - Graph traversal → Graph DB
+   - Similarity search → Vector DB
+   - Simple lookups → Key-value store
+
+3. **Analyze Scale Requirements**:
+   - < 1M records → SQLite, PostgreSQL, MySQL
+   - 1M - 100M records → PostgreSQL, MySQL, MongoDB
+   - > 100M records → Distributed DB (DynamoDB, Cassandra)
+
+4. **Consider Operational Requirements**:
+   - ACID guarantees needed → Relational
+   - Eventual consistency acceptable → NoSQL
+   - Managed service preferred → Cloud-native (RDS, DynamoDB)
+   - Self-hosted required → PostgreSQL, MySQL, MongoDB
+
+**Output**: Database selection with documented rationale
+
+**AI Prompt Template**:
+```
+I need to select a database for [use case]. Requirements:
+- Data structure: [structured/semi-structured/unstructured]
+- Query patterns: [describe common queries]
+- Scale: [number of records, growth rate]
+- Consistency needs: [strong/eventual]
+- Operational constraints: [managed/self-hosted, budget]
+
+Please recommend a database type and specific database, with rationale.
+```
+
+### Step 2: Schema Design
+
+**Purpose**: Design optimal database schema
+
+See `schema-design-workflow.md` for detailed guidance.
+
+**Quick Steps**:
+1. Identify entities and attributes
+2. Map relationships between entities
+3. Apply normalization (relational) or denormalization (NoSQL)
+4. Define constraints and validation rules
+5. Plan indexes for common queries
+6. Review and validate design
+
+**Output**: Schema design document with ERD or data model
+
+### Step 3: Implementation
+
+**Purpose**: Create database schema in target database
+
+**Steps**:
+
+1. **Set Up Database Environment**:
+   - Install database locally or provision cloud instance
+   - Configure connection settings
+   - Set up database users and permissions
+
+2. **Create Schema**:
+   - Write DDL (Data Definition Language) scripts
+   - Include comments for documentation
+   - Add constraints and indexes
+   - Version control schema files
+
+3. **Seed Initial Data** (if needed):
+   - Create seed data scripts
+   - Include reference data (countries, categories, etc.)
+   - Document data sources
+
+**Output**: Executable schema scripts in version control
+
+**AI Prompt Template**:
+```
+Create database schema for [database type] based on this design:
+
+[paste schema design]
+
+Requirements:
+- Include table/collection definitions
+- Add appropriate constraints
+- Create indexes for common queries
+- Add comments for documentation
+- Make scripts idempotent
+
+Please generate DDL/schema creation scripts.
+```
+
+### Step 4: Migration Management
+
+**Purpose**: Safely evolve database schema over time
+
+See `data-migration.md` for detailed guidance.
+
+**Quick Steps**:
+1. Plan migration (what changes, impact, rollback)
+2. Create up and down migration scripts
+3. Test on staging data
+4. Execute migration with monitoring
+5. Verify success and data integrity
+
+**Output**: Versioned migration scripts with rollback plans
+
+### Step 5: Optimization
+
+**Purpose**: Improve database performance
+
+See `optimization-workflow.md` for detailed guidance.
+
+**Quick Steps**:
+1. Identify slow queries (profiling, logs)
+2. Analyze query execution plans
+3. Add or optimize indexes
+4. Refactor queries
+5. Consider denormalization or caching
+6. Measure improvements
+
+**Output**: Optimized queries and schema with performance metrics
+
+### Step 6: Testing
+
+**Purpose**: Validate database behavior and performance
+
+See `testing-patterns.md` for detailed guidance.
+
+**Quick Steps**:
+1. Set up test database environment
+2. Create test fixtures and seed data
+3. Write unit tests (constraints, validation)
+4. Write integration tests (queries, transactions)
+5. Write performance tests (load, stress)
+6. Run tests in CI/CD pipeline
+
+**Output**: Comprehensive test suite with fixtures
+
+---
+
+## Database Type-Specific Workflows
+
+### Relational Databases (PostgreSQL, MySQL, SQL Server)
+
+**Schema Design**:
+- Normalize to 3NF (Third Normal Form)
+- Use foreign keys for referential integrity
+- Add check constraints for validation
+- Create indexes on foreign keys and query columns
+
+**Migration Tools**:
+- **PostgreSQL**: Flyway, Liquibase, Alembic (Python), Knex (Node.js)
+- **MySQL**: Flyway, Liquibase, Laravel Migrations (PHP)
+- **SQL Server**: Entity Framework Migrations, Flyway
+
+**Best Practices**:
+- Use transactions for data consistency
+- Add indexes carefully (balance read vs write performance)
+- Use EXPLAIN/EXPLAIN ANALYZE to understand query plans
+- Monitor connection pool usage
+
+### NoSQL Databases (MongoDB, DynamoDB)
+
+**Schema Design**:
+- Denormalize for query efficiency
+- Embed related data in documents
+- Use references for large or frequently updated data
+- Design for access patterns, not normalization
+
+**Migration Strategies**:
+- Schema-less doesn't mean schema-free
+- Version documents with schema version field
+- Migrate data lazily (on read) or in batches
+- Use application-level schema validation
+
+**Best Practices**:
+- Design for your query patterns
+- Avoid large documents (> 16MB in MongoDB)
+- Use indexes on query fields
+- Monitor document size and collection growth
+
+### Vector Databases (Pinecone, Milvus, Weaviate)
+
+**Schema Design**:
+- Define vector dimensions (match embedding model)
+- Choose distance metric (cosine, euclidean, dot product)
+- Plan metadata fields for filtering
+- Consider hybrid search (vector + keyword)
+
+**Index Configuration**:
+- Choose index type (HNSW, IVF, etc.)
+- Tune index parameters (ef_construction, M)
+- Balance accuracy vs speed
+- Plan for index rebuild time
+
+**Best Practices**:
+- Normalize vectors before insertion
+- Use metadata filtering to reduce search space
+- Batch insertions for better performance
+- Monitor index size and query latency
+
+### Flat Databases (CSV, JSON files)
+
+**Schema Design**:
+- Define clear column/field names
+- Document data types and formats
+- Use consistent date/time formats (ISO 8601)
+- Plan for schema evolution
+
+**File Management**:
+- Use version control for schema definitions
+- Validate data on read/write
+- Consider file size limits (split large files)
+- Use compression for storage efficiency
+
+**Best Practices**:
+- Validate data with JSON Schema or CSV schema
+- Use streaming for large files
+- Implement proper error handling
+- Consider migration to database if data grows
+
+---
+
+## AI Prompt Templates
+
+### Database Selection
+
+```
+I need to select a database for [application type]. Requirements:
+
+**Data Characteristics**:
+- Structure: [structured/semi-structured/unstructured]
+- Volume: [current size, growth rate]
+- Relationships: [simple/complex graph]
+
+**Query Patterns**:
+- [Query pattern 1]: [frequency, complexity]
+- [Query pattern 2]: [frequency, complexity]
+
+**Non-Functional Requirements**:
+- Consistency: [strong ACID / eventual consistency]
+- Availability: [uptime requirements]
+- Scale: [read/write throughput]
+- Budget: [constraints]
+- Expertise: [team skills]
+
+Please recommend a database with rationale and trade-offs.
+```
+
+### Schema Design
+
+```
+Design a database schema for [application type].
+
+**Entities**:
+- [Entity 1]: [attributes and types]
+- [Entity 2]: [attributes and types]
+
+**Relationships**:
+- [Entity 1] [relationship type] [Entity 2]
+
+**Common Queries**:
+- [Query 1]: [description]
+- [Query 2]: [description]
+
+**Constraints**:
+- [Constraint 1]
+- [Constraint 2]
+
+Please design an optimal schema with normalization, constraints, and indexes.
+```
+
+### Migration Planning
+
+```
+Plan a database migration for [describe change].
+
+**Current Schema**:
+[paste current schema]
+
+**Desired Schema**:
+[paste desired schema or describe changes]
+
+**Constraints**:
+- Zero downtime: [yes/no]
+- Backward compatibility: [yes/no]
+- Data volume: [number of rows]
+- Database: [type and version]
+
+Please create a migration plan with up/down scripts and rollback strategy.
+```
+
+### Query Optimization
+
+```
+Optimize this slow query:
+
+**Query**:
+[paste query]
+
+**Execution Plan**:
+[paste EXPLAIN output]
+
+**Schema**:
+[paste relevant table definitions]
+
+**Performance Issue**:
+- Current execution time: [time]
+- Target execution time: [time]
+- Data volume: [number of rows]
+
+Please suggest optimizations (indexes, query rewrite, schema changes).
+```
+
+---
+
+## Best Practices
+
+### DO
+
+✅ Document database selection rationale
+✅ Version control all schema and migration scripts
+✅ Test migrations on production-like data
+✅ Monitor database performance metrics
+✅ Use transactions for data consistency
+✅ Add indexes based on query patterns
+✅ Plan for rollback before executing migrations
+✅ Use connection pooling in applications
+
+### DON'T
+
+❌ Choose database without analyzing requirements
+❌ Make schema changes without migration scripts
+❌ Skip testing migrations before production
+❌ Add indexes without measuring impact
+❌ Store sensitive data without encryption
+❌ Ignore database performance metrics
+❌ Deploy code and schema changes simultaneously
+❌ Forget to document design decisions
+
+---
+
+## Common Pitfalls
+
+**Pitfall 1: Premature Optimization**
+- ❌ Adding indexes before understanding query patterns
+- ✅ Profile queries first, then optimize based on data
+
+**Pitfall 2: Over-Normalization**
+- ❌ Normalizing to 5NF causing excessive joins
+- ✅ Balance normalization with query performance
+
+**Pitfall 3: Under-Indexing**
+- ❌ No indexes on foreign keys or query columns
+- ✅ Add indexes for common query patterns
+
+**Pitfall 4: Ignoring Migrations**
+- ❌ Making schema changes directly in production
+- ✅ Use versioned migration scripts with rollback
+
+**Pitfall 5: Not Testing at Scale**
+- ❌ Testing with small datasets
+- ✅ Test with production-like data volumes
+
+---
+
+## Next Steps
+
+- See `schema-design-workflow.md` for detailed schema design process
+- See `data-migration.md` for migration management strategies
+- See `optimization-workflow.md` for performance tuning guidance
+- See `testing-patterns.md` for database testing approaches
+- See `documentation-standards.md` for documenting database designs
+

package/augment-extensions/workflows/openspec/module.json

@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "displayName": "OpenSpec Workflow",
   "description": "Spec-driven development (SDD) workflow for AI coding assistants. Provides structured change management with proposals, specs, and tasks.",
-  "type": "workflow",
+  "type": "workflows",
   "author": "Augment Extensions",
   "license": "MIT",
   "keywords": [
@@ -16,9 +16,10 @@
     "change-management"
   ],
   "augment": {
-    "characterCount": 30509,
+    "characterCount": 32661,
     "priority": "high",
-    "category": "workflow",
+    "category": "workflows",
+    "tags": ["openspec", "spec-driven-development", "workflow", "change-management"],
     "compatibleWith": [
       "Claude Code",
       "CodeBuddy",

package/augment-extensions/writing-standards/screenplay/README.md

@@ -0,0 +1,171 @@
+# Screenplay Writing Standards
+
+## Overview
+
+Comprehensive screenplay writing and crafting standards for AI-driven content creation across multiple formats and industries.
+
+**Version**: 1.0.0  
+**Type**: writing-standards  
+**Character Count**: ~TBD
+
+## Key Benefits
+
+✅ **Industry-Standard Formatting** - AMPAS Nicholl Fellowship formatting standards  
+✅ **Narrative Frameworks** - Syd Field, Blake Snyder, Joseph Campbell structures  
+✅ **Category-Specific Rules** - 8 screenplay categories (Hollywood, indie, TV, web, news, commercials, streaming, live TV)  
+✅ **Character Development** - Programmatic character arcs, traits, motivations  
+✅ **Dialogue Mastery** - Natural speech, subtext, character voice  
+✅ **Screen Continuity** - Visual consistency rules (180-degree rule, match cuts)  
+✅ **Fountain Format** - Industry-standard plain-text screenplay markup  
+✅ **VS Code Integration** - Better Fountain extension support  
+✅ **Export Tools** - Final Draft (.fdx), PDF, HTML export
+
+## Installation
+
+### With CLI (Recommended)
+
+```bash
+augx link writing-standards/screenplay
+```
+
+### Manual Setup
+
+1. Copy `augment-extensions/writing-standards/screenplay/` to your project
+2. Create `.augment/screenplay-config.json` with category selection
+3. Reference rule files in your AI prompts
+
+## Configuration
+
+Create `.augment/screenplay-config.json`:
+
+```json
+{
+  "categories": ["aaa-hollywood-films"],
+  "universalRules": true,
+  "fountainFormat": true,
+  "exportFormats": ["fdx", "pdf"]
+}
+```
+
+### Available Categories
+
+1. **aaa-hollywood-films** - AAA Hollywood blockbusters
+2. **independent-films** - Independent/art-house films
+3. **tv-series** - Television series (episodic)
+4. **web-content** - Web series and short-form content
+5. **news-broadcasts** - News segments and broadcasts
+6. **commercials** - Advertising and commercials
+7. **streaming-content** - Streaming platform content
+8. **live-tv-productions** - Live TV productions
+
+## Directory Structure
+
+```
+augment-extensions/writing-standards/screenplay/
+├── module.json                    # Module metadata
+├── README.md                      # This file
+├── rules/                         # Screenplay writing rules
+│   ├── universal-formatting.md   # AMPAS formatting standards
+│   ├── narrative-structures.md   # Three-act, beat sheets, hero's journey
+│   ├── character-development.md  # Character arcs and development
+│   ├── dialogue-writing.md       # Dialogue best practices
+│   ├── screen-continuity.md      # Visual consistency rules
+│   ├── pacing-timing.md          # Pacing and timing guidelines
+│   ├── diversity-inclusion.md    # Diversity and inclusion standards
+│   ├── aaa-hollywood-films.md    # AAA Hollywood category rules
+│   ├── independent-films.md      # Independent film category rules
+│   ├── tv-series.md              # TV series category rules
+│   ├── web-content.md            # Web content category rules
+│   ├── news-broadcasts.md        # News broadcast category rules
+│   ├── commercials.md            # Commercial category rules
+│   ├── streaming-content.md      # Streaming content category rules
+│   └── live-tv-productions.md    # Live TV category rules
+├── schemas/                       # JSON schemas for screenplay data
+│   ├── character-profile.json    # Character profile schema
+│   ├── beat-sheet.json           # Beat sheet schema
+│   ├── plot-outline.json         # Plot outline schema
+│   └── trope-inventory.json      # Trope inventory schema
+└── examples/                      # Example screenplay files
+    ├── aaa-hollywood-scene.fountain
+    ├── independent-monologue.fountain
+    ├── tv-episode-teaser.fountain
+    ├── news-segment.fountain
+    ├── commercial-30sec.fountain
+    ├── character-profile-example.yaml
+    ├── beat-sheet-example.yaml
+    └── plot-outline-example.yaml
+```
+
+## Core Guidelines
+
+### Universal Formatting (AMPAS Standards)
+
+- **Font**: 12-point Courier or Courier New
+- **Margins**: 1-inch top/bottom/right, 1.5-inch left
+- **Page Length**: ~1 page per minute of screen time
+- **Scene Headings**: ALL CAPS, INT./EXT., location, time of day
+- **Action**: Present tense, active voice, visual descriptions
+- **Dialogue**: Character name centered, dialogue indented
+- **Transitions**: RIGHT-ALIGNED (FADE IN:, CUT TO:, DISSOLVE TO:)
+
+### Narrative Structures
+
+1. **Three-Act Structure** (Syd Field)
+   - Act I: Setup (25% - pages 1-30)
+   - Act II: Confrontation (50% - pages 30-90)
+   - Act III: Resolution (25% - pages 90-120)
+
+2. **Save the Cat Beat Sheet** (Blake Snyder)
+   - Opening Image, Theme Stated, Setup, Catalyst, Debate, Break into Two, B Story, Fun and Games, Midpoint, Bad Guys Close In, All Is Lost, Dark Night of the Soul, Break into Three, Finale, Final Image
+
+3. **Hero's Journey** (Joseph Campbell)
+   - Ordinary World, Call to Adventure, Refusal, Meeting the Mentor, Crossing the Threshold, Tests/Allies/Enemies, Approach, Ordeal, Reward, The Road Back, Resurrection, Return with Elixir
+
+### Character Development
+
+- **Character Arc**: Transformation from beginning to end
+- **Traits**: Physical, psychological, sociological
+- **Motivations**: Internal and external goals
+- **Relationships**: Protagonist, antagonist, allies, mentors
+- **Dialogue Voice**: Unique speech patterns per character
+
+## VS Code Integration
+
+### Better Fountain Extension
+
+1. Install: `ext install piersdeseilligny.betterfountain`
+2. Open `.fountain` files for syntax highlighting
+3. Use `Ctrl+Shift+P` → "Fountain: Export to PDF"
+
+### Fountain Syntax
+
+```fountain
+INT. COFFEE SHOP - DAY
+
+SARAH, 30s, sits alone with a laptop.
+
+SARAH
+(to herself)
+This is it. The moment of truth.
+
+She hits ENTER. Waits.
+
+FADE OUT.
+```
+
+## Export Formats
+
+- **Final Draft (.fdx)**: Industry-standard format
+- **PDF**: Print-ready screenplay
+- **HTML**: Web-friendly format
+
+## References
+
+- [AMPAS Nicholl Fellowship Requirements](https://www.oscars.org/nicholl/requirements)
+- [Fountain Specification](https://fountain.io/)
+- [Final Draft](https://www.finaldraft.com/)
+- Syd Field: "Screenplay: The Foundations of Screenwriting"
+- Blake Snyder: "Save the Cat!"
+- Joseph Campbell: "The Hero with a Thousand Faces"
+- Robert McKee: "Story"
+