@mytechtoday/augment-extensions 0.7.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +265 -232
- package/README.md +956 -771
- package/augment-extensions/coding-standards/bash/README.md +196 -196
- package/augment-extensions/coding-standards/bash/module.json +163 -163
- package/augment-extensions/coding-standards/bash/rules/naming-conventions.md +336 -336
- package/augment-extensions/coding-standards/bash/rules/universal-standards.md +289 -289
- package/augment-extensions/coding-standards/css/README.md +40 -40
- package/augment-extensions/coding-standards/css/examples/css-examples.css +550 -550
- package/augment-extensions/coding-standards/css/module.json +44 -44
- package/augment-extensions/coding-standards/css/rules/css-modern-features.md +448 -448
- package/augment-extensions/coding-standards/css/rules/css-standards.md +492 -492
- package/augment-extensions/coding-standards/html/README.md +40 -40
- package/augment-extensions/coding-standards/html/examples/html-examples.html +267 -267
- package/augment-extensions/coding-standards/html/examples/responsive-layout.html +505 -505
- package/augment-extensions/coding-standards/html/module.json +44 -44
- package/augment-extensions/coding-standards/html/rules/html-standards.md +349 -349
- package/augment-extensions/coding-standards/html-css-js/README.md +194 -194
- package/augment-extensions/coding-standards/html-css-js/examples/async-examples.js +487 -487
- package/augment-extensions/coding-standards/html-css-js/examples/css-examples.css +550 -550
- package/augment-extensions/coding-standards/html-css-js/examples/dom-examples.js +667 -667
- package/augment-extensions/coding-standards/html-css-js/examples/html-examples.html +267 -267
- package/augment-extensions/coding-standards/html-css-js/examples/javascript-examples.js +612 -612
- package/augment-extensions/coding-standards/html-css-js/examples/responsive-layout.html +505 -505
- package/augment-extensions/coding-standards/html-css-js/module.json +48 -48
- package/augment-extensions/coding-standards/html-css-js/rules/async-patterns.md +515 -515
- package/augment-extensions/coding-standards/html-css-js/rules/css-modern-features.md +448 -448
- package/augment-extensions/coding-standards/html-css-js/rules/css-standards.md +492 -492
- package/augment-extensions/coding-standards/html-css-js/rules/dom-manipulation.md +439 -439
- package/augment-extensions/coding-standards/html-css-js/rules/html-standards.md +349 -349
- package/augment-extensions/coding-standards/html-css-js/rules/javascript-standards.md +486 -486
- package/augment-extensions/coding-standards/html-css-js/rules/performance.md +463 -463
- package/augment-extensions/coding-standards/html-css-js/rules/tooling.md +543 -543
- package/augment-extensions/coding-standards/js/README.md +46 -46
- package/augment-extensions/coding-standards/js/examples/async-examples.js +487 -487
- package/augment-extensions/coding-standards/js/examples/dom-examples.js +667 -667
- package/augment-extensions/coding-standards/js/examples/javascript-examples.js +612 -612
- package/augment-extensions/coding-standards/js/module.json +49 -49
- package/augment-extensions/coding-standards/js/rules/async-patterns.md +515 -515
- package/augment-extensions/coding-standards/js/rules/dom-manipulation.md +439 -439
- package/augment-extensions/coding-standards/js/rules/javascript-standards.md +486 -486
- package/augment-extensions/coding-standards/js/rules/performance.md +463 -463
- package/augment-extensions/coding-standards/js/rules/tooling.md +543 -543
- package/augment-extensions/coding-standards/php/README.md +248 -248
- package/augment-extensions/coding-standards/php/examples/api-endpoint-example.php +204 -204
- package/augment-extensions/coding-standards/php/examples/cli-command-example.php +206 -206
- package/augment-extensions/coding-standards/php/examples/legacy-refactoring-example.php +234 -234
- package/augment-extensions/coding-standards/php/examples/web-application-example.php +211 -211
- package/augment-extensions/coding-standards/php/examples/woocommerce-extension-example.php +215 -215
- package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php +189 -189
- package/augment-extensions/coding-standards/php/module.json +166 -166
- package/augment-extensions/coding-standards/php/rules/api-development.md +480 -480
- package/augment-extensions/coding-standards/php/rules/category-configuration.md +332 -332
- package/augment-extensions/coding-standards/php/rules/cli-tools.md +472 -472
- package/augment-extensions/coding-standards/php/rules/cms-integration.md +561 -561
- package/augment-extensions/coding-standards/php/rules/code-quality.md +402 -402
- package/augment-extensions/coding-standards/php/rules/documentation.md +425 -425
- package/augment-extensions/coding-standards/php/rules/ecommerce.md +627 -627
- package/augment-extensions/coding-standards/php/rules/error-handling.md +336 -336
- package/augment-extensions/coding-standards/php/rules/legacy-migration.md +677 -677
- package/augment-extensions/coding-standards/php/rules/naming-conventions.md +279 -279
- package/augment-extensions/coding-standards/php/rules/performance.md +392 -392
- package/augment-extensions/coding-standards/php/rules/psr-standards.md +186 -186
- package/augment-extensions/coding-standards/php/rules/security.md +358 -358
- package/augment-extensions/coding-standards/php/rules/testing.md +403 -403
- package/augment-extensions/coding-standards/php/rules/type-declarations.md +331 -331
- package/augment-extensions/coding-standards/php/rules/web-applications.md +426 -426
- package/augment-extensions/coding-standards/powershell/README.md +154 -154
- package/augment-extensions/coding-standards/powershell/examples/admin-example.ps1 +272 -272
- package/augment-extensions/coding-standards/powershell/examples/automation-example.ps1 +173 -173
- package/augment-extensions/coding-standards/powershell/examples/cloud-example.ps1 +243 -243
- package/augment-extensions/coding-standards/powershell/examples/cross-platform-example.ps1 +297 -297
- package/augment-extensions/coding-standards/powershell/examples/dsc-example.ps1 +224 -224
- package/augment-extensions/coding-standards/powershell/examples/legacy-migration-example.ps1 +340 -340
- package/augment-extensions/coding-standards/powershell/examples/module-example.psm1 +255 -255
- package/augment-extensions/coding-standards/powershell/module.json +165 -165
- package/augment-extensions/coding-standards/powershell/rules/administrative-tools.md +439 -439
- package/augment-extensions/coding-standards/powershell/rules/automation-scripts.md +240 -240
- package/augment-extensions/coding-standards/powershell/rules/cloud-orchestration.md +384 -384
- package/augment-extensions/coding-standards/powershell/rules/configuration-schema.md +383 -383
- package/augment-extensions/coding-standards/powershell/rules/cross-platform-scripts.md +482 -482
- package/augment-extensions/coding-standards/powershell/rules/dsc-configurations.md +296 -296
- package/augment-extensions/coding-standards/powershell/rules/error-handling.md +314 -314
- package/augment-extensions/coding-standards/powershell/rules/legacy-migrations.md +466 -466
- package/augment-extensions/coding-standards/powershell/rules/modules-functions.md +244 -244
- package/augment-extensions/coding-standards/powershell/rules/naming-conventions.md +266 -266
- package/augment-extensions/coding-standards/powershell/rules/performance-optimization.md +209 -209
- package/augment-extensions/coding-standards/powershell/rules/security-practices.md +314 -314
- package/augment-extensions/coding-standards/powershell/rules/testing-guidelines.md +268 -268
- package/augment-extensions/coding-standards/powershell/rules/universal-standards.md +197 -197
- package/augment-extensions/coding-standards/python/README.md +48 -48
- package/augment-extensions/coding-standards/python/examples/best-practices.py +373 -373
- package/augment-extensions/coding-standards/python/module.json +30 -30
- package/augment-extensions/coding-standards/python/rules/async-patterns.md +884 -884
- package/augment-extensions/coding-standards/python/rules/best-practices.md +232 -232
- package/augment-extensions/coding-standards/python/rules/code-organization.md +220 -220
- package/augment-extensions/coding-standards/python/rules/documentation.md +831 -831
- package/augment-extensions/coding-standards/python/rules/error-handling.md +1008 -1008
- package/augment-extensions/coding-standards/python/rules/naming-conventions.md +172 -172
- package/augment-extensions/coding-standards/python/rules/testing.md +409 -409
- package/augment-extensions/coding-standards/python/rules/tooling.md +446 -446
- package/augment-extensions/coding-standards/python/rules/type-hints.md +253 -253
- package/augment-extensions/coding-standards/react/README.md +45 -45
- package/augment-extensions/coding-standards/react/module.json +27 -27
- package/augment-extensions/coding-standards/react/rules/component-patterns.md +214 -214
- package/augment-extensions/coding-standards/react/rules/hooks-best-practices.md +235 -235
- package/augment-extensions/coding-standards/react/rules/performance.md +300 -300
- package/augment-extensions/coding-standards/react/rules/state-management.md +265 -265
- package/augment-extensions/coding-standards/react/rules/typescript-react.md +271 -271
- package/augment-extensions/coding-standards/typescript/README.md +45 -45
- package/augment-extensions/coding-standards/typescript/module.json +27 -27
- package/augment-extensions/coding-standards/typescript/rules/naming-conventions.md +225 -225
- package/augment-extensions/collections/html-css-js/README.md +82 -82
- package/augment-extensions/collections/html-css-js/collection.json +41 -41
- package/augment-extensions/domain-rules/api-design/README.md +41 -41
- package/augment-extensions/domain-rules/api-design/module.json +27 -27
- package/augment-extensions/domain-rules/api-design/rules/authentication.md +263 -263
- package/augment-extensions/domain-rules/api-design/rules/documentation.md +395 -395
- package/augment-extensions/domain-rules/api-design/rules/error-handling.md +290 -290
- package/augment-extensions/domain-rules/api-design/rules/graphql-api.md +313 -313
- package/augment-extensions/domain-rules/api-design/rules/rest-api.md +214 -214
- package/augment-extensions/domain-rules/api-design/rules/versioning.md +268 -268
- package/augment-extensions/domain-rules/database/README.md +161 -161
- package/augment-extensions/domain-rules/database/examples/flat-database-example.md +793 -793
- package/augment-extensions/domain-rules/database/examples/hybrid-database-example.md +1132 -1132
- package/augment-extensions/domain-rules/database/examples/nosql-document-example.md +868 -868
- package/augment-extensions/domain-rules/database/examples/nosql-graph-example.md +805 -805
- package/augment-extensions/domain-rules/database/examples/relational-schema-example.md +621 -621
- package/augment-extensions/domain-rules/database/examples/vector-database-example.md +965 -965
- package/augment-extensions/domain-rules/database/module.json +28 -28
- package/augment-extensions/domain-rules/database/rules/flat-databases.md +624 -624
- package/augment-extensions/domain-rules/database/rules/nosql-databases.md +588 -588
- package/augment-extensions/domain-rules/database/rules/nosql-document-stores.md +856 -856
- package/augment-extensions/domain-rules/database/rules/nosql-graph-databases.md +778 -778
- package/augment-extensions/domain-rules/database/rules/nosql-key-value-stores.md +963 -963
- package/augment-extensions/domain-rules/database/rules/performance-optimization.md +1076 -1076
- package/augment-extensions/domain-rules/database/rules/relational-databases.md +697 -697
- package/augment-extensions/domain-rules/database/rules/relational-indexing.md +671 -671
- package/augment-extensions/domain-rules/database/rules/relational-query-optimization.md +607 -607
- package/augment-extensions/domain-rules/database/rules/relational-schema-design.md +907 -907
- package/augment-extensions/domain-rules/database/rules/relational-transactions.md +783 -783
- package/augment-extensions/domain-rules/database/rules/security-standards.md +980 -980
- package/augment-extensions/domain-rules/database/rules/universal-best-practices.md +485 -485
- package/augment-extensions/domain-rules/database/rules/vector-databases.md +521 -521
- package/augment-extensions/domain-rules/database/rules/vector-embeddings.md +858 -858
- package/augment-extensions/domain-rules/database/rules/vector-indexing.md +934 -934
- package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -27
- package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -26
- package/augment-extensions/domain-rules/mcp/README.md +150 -150
- package/augment-extensions/domain-rules/mcp/examples/compressed-example.md +522 -522
- package/augment-extensions/domain-rules/mcp/examples/graph-augmented-example.md +520 -520
- package/augment-extensions/domain-rules/mcp/examples/hybrid-example.md +570 -570
- package/augment-extensions/domain-rules/mcp/examples/state-based-example.md +427 -427
- package/augment-extensions/domain-rules/mcp/examples/token-based-example.md +435 -435
- package/augment-extensions/domain-rules/mcp/examples/vector-based-example.md +502 -502
- package/augment-extensions/domain-rules/mcp/module.json +49 -49
- package/augment-extensions/domain-rules/mcp/rules/compressed-mcp.md +595 -595
- package/augment-extensions/domain-rules/mcp/rules/configuration.md +345 -345
- package/augment-extensions/domain-rules/mcp/rules/graph-augmented-mcp.md +687 -687
- package/augment-extensions/domain-rules/mcp/rules/hybrid-mcp.md +636 -636
- package/augment-extensions/domain-rules/mcp/rules/state-based-mcp.md +484 -484
- package/augment-extensions/domain-rules/mcp/rules/testing-validation.md +360 -360
- package/augment-extensions/domain-rules/mcp/rules/token-based-mcp.md +393 -393
- package/augment-extensions/domain-rules/mcp/rules/universal-rules.md +194 -194
- package/augment-extensions/domain-rules/mcp/rules/vector-based-mcp.md +625 -625
- package/augment-extensions/domain-rules/security/README.md +41 -41
- package/augment-extensions/domain-rules/security/module.json +28 -28
- package/augment-extensions/domain-rules/security/rules/authentication-security.md +361 -361
- package/augment-extensions/domain-rules/security/rules/encryption.md +208 -208
- package/augment-extensions/domain-rules/security/rules/input-validation.md +294 -294
- package/augment-extensions/domain-rules/security/rules/owasp-top-10.md +339 -339
- package/augment-extensions/domain-rules/security/rules/secure-coding.md +293 -293
- package/augment-extensions/domain-rules/security/rules/web-security.md +268 -268
- package/augment-extensions/domain-rules/seo-sales-marketing/ANNOUNCEMENT.md +143 -0
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/README.md +140 -136
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/SCHEMA-VALIDATION-REPORT.md +216 -216
- package/augment-extensions/domain-rules/seo-sales-marketing/TEST-VALIDATION.md +129 -0
- package/augment-extensions/domain-rules/seo-sales-marketing/USAGE-GUIDES.md +254 -0
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/brand-kit-example.yaml +292 -292
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/campaign-brief-example.yaml +389 -389
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/content-calendar-example.yaml +643 -643
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/email-newsletter-example.md +376 -376
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/landing-page-example.md +934 -934
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/ppc-ad-copy-example.md +301 -301
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/seo-blog-post-example.md +347 -347
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/social-media-campaign-example.md +606 -606
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/module.json +50 -50
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/affiliate-influencer-marketing.md +593 -593
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/asset-management.md +418 -418
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/brand-consistency.md +210 -210
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/content-marketing.md +337 -337
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/conversion-optimization.md +455 -455
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/direct-sales.md +499 -499
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/email-marketing.md +439 -439
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/legal-compliance.md +227 -227
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/ppc-advertising.md +569 -569
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/seo-optimization.md +470 -470
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/social-media-marketing.md +414 -414
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/universal-marketing.md +177 -177
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/asset-inventory.schema.json +247 -247
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/brand-kit.schema.json +326 -326
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/campaign-brief.schema.json +342 -342
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/color-palette.schema.json +223 -223
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/content-template.schema.json +383 -383
- package/augment-extensions/domain-rules/wordpress/README.md +163 -163
- package/augment-extensions/domain-rules/wordpress/module.json +32 -32
- package/augment-extensions/domain-rules/wordpress/rules/coding-standards.md +617 -617
- package/augment-extensions/domain-rules/wordpress/rules/directory-structure.md +270 -270
- package/augment-extensions/domain-rules/wordpress/rules/file-patterns.md +423 -423
- package/augment-extensions/domain-rules/wordpress/rules/gutenberg-blocks.md +493 -493
- package/augment-extensions/domain-rules/wordpress/rules/performance.md +568 -568
- package/augment-extensions/domain-rules/wordpress/rules/plugin-development.md +510 -510
- package/augment-extensions/domain-rules/wordpress/rules/project-detection.md +251 -251
- package/augment-extensions/domain-rules/wordpress/rules/rest-api.md +501 -501
- package/augment-extensions/domain-rules/wordpress/rules/security.md +564 -564
- package/augment-extensions/domain-rules/wordpress/rules/theme-development.md +388 -388
- package/augment-extensions/domain-rules/wordpress/rules/woocommerce.md +441 -441
- package/augment-extensions/domain-rules/wordpress-plugin/README.md +139 -139
- package/augment-extensions/domain-rules/wordpress-plugin/examples/ajax-plugin.md +1599 -1599
- package/augment-extensions/domain-rules/wordpress-plugin/examples/custom-post-type-plugin.md +1727 -1727
- package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block-plugin.md +428 -428
- package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block.md +422 -422
- package/augment-extensions/domain-rules/wordpress-plugin/examples/mvc-plugin.md +1623 -1623
- package/augment-extensions/domain-rules/wordpress-plugin/examples/object-oriented-plugin.md +1343 -1343
- package/augment-extensions/domain-rules/wordpress-plugin/examples/rest-endpoint.md +734 -734
- package/augment-extensions/domain-rules/wordpress-plugin/examples/settings-page-plugin.md +1350 -1350
- package/augment-extensions/domain-rules/wordpress-plugin/examples/simple-procedural-plugin.md +503 -503
- package/augment-extensions/domain-rules/wordpress-plugin/examples/singleton-plugin.md +971 -971
- package/augment-extensions/domain-rules/wordpress-plugin/module.json +53 -53
- package/augment-extensions/domain-rules/wordpress-plugin/rules/activation-hooks.md +770 -770
- package/augment-extensions/domain-rules/wordpress-plugin/rules/admin-interface.md +874 -874
- package/augment-extensions/domain-rules/wordpress-plugin/rules/ajax-handlers.md +629 -629
- package/augment-extensions/domain-rules/wordpress-plugin/rules/asset-management.md +559 -559
- package/augment-extensions/domain-rules/wordpress-plugin/rules/context-providers.md +709 -709
- package/augment-extensions/domain-rules/wordpress-plugin/rules/cron-jobs.md +736 -736
- package/augment-extensions/domain-rules/wordpress-plugin/rules/database-management.md +1057 -1057
- package/augment-extensions/domain-rules/wordpress-plugin/rules/documentation-standards.md +463 -463
- package/augment-extensions/domain-rules/wordpress-plugin/rules/frontend-functionality.md +478 -478
- package/augment-extensions/domain-rules/wordpress-plugin/rules/gutenberg-blocks.md +818 -818
- package/augment-extensions/domain-rules/wordpress-plugin/rules/internationalization.md +416 -416
- package/augment-extensions/domain-rules/wordpress-plugin/rules/migration.md +667 -667
- package/augment-extensions/domain-rules/wordpress-plugin/rules/performance-optimization.md +878 -878
- package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-architecture.md +693 -693
- package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-structure.md +352 -352
- package/augment-extensions/domain-rules/wordpress-plugin/rules/rest-api.md +818 -818
- package/augment-extensions/domain-rules/wordpress-plugin/rules/scaffolding-workflow.md +624 -624
- package/augment-extensions/domain-rules/wordpress-plugin/rules/security-best-practices.md +866 -866
- package/augment-extensions/domain-rules/wordpress-plugin/rules/testing-patterns.md +1165 -1165
- package/augment-extensions/domain-rules/wordpress-plugin/rules/testing.md +414 -414
- package/augment-extensions/domain-rules/wordpress-plugin/rules/vscode-integration.md +751 -751
- package/augment-extensions/domain-rules/wordpress-plugin/rules/woocommerce-integration.md +949 -949
- package/augment-extensions/domain-rules/wordpress-plugin/rules/wordpress-org-submission.md +458 -458
- package/augment-extensions/examples/design-patterns/README.md +37 -37
- package/augment-extensions/examples/design-patterns/examples/behavioral-patterns.md +370 -370
- package/augment-extensions/examples/design-patterns/examples/creational-patterns.md +250 -250
- package/augment-extensions/examples/design-patterns/examples/structural-patterns.md +264 -264
- package/augment-extensions/examples/design-patterns/module.json +27 -27
- package/augment-extensions/examples/gutenberg-block-plugin/README.md +101 -101
- package/augment-extensions/examples/gutenberg-block-plugin/examples/testimonial-block.md +428 -428
- package/augment-extensions/examples/gutenberg-block-plugin/module.json +40 -40
- package/augment-extensions/examples/rest-api-plugin/README.md +98 -98
- package/augment-extensions/examples/rest-api-plugin/examples/task-manager-api.md +1299 -1299
- package/augment-extensions/examples/rest-api-plugin/module.json +40 -40
- package/augment-extensions/examples/woocommerce-extension/README.md +98 -98
- package/augment-extensions/examples/woocommerce-extension/examples/product-customizer.md +763 -763
- package/augment-extensions/examples/woocommerce-extension/module.json +40 -40
- package/augment-extensions/workflows/beads/README.md +135 -135
- package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +278 -278
- package/augment-extensions/workflows/beads/module.json +55 -55
- package/augment-extensions/workflows/beads/rules/best-practices.md +398 -398
- package/augment-extensions/workflows/beads/rules/file-format.md +327 -327
- package/augment-extensions/workflows/beads/rules/manual-setup.md +315 -315
- package/augment-extensions/workflows/beads/rules/workflow.md +326 -326
- package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -145
- package/augment-extensions/workflows/beads-integration/README.md +143 -143
- package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -32
- package/augment-extensions/workflows/beads-integration/config/schema.json +140 -140
- package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -293
- package/augment-extensions/workflows/beads-integration/module.json +75 -75
- package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -219
- package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -256
- package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -607
- package/augment-extensions/workflows/database/README.md +195 -195
- package/augment-extensions/workflows/database/ai-prompt-testing.md +295 -295
- package/augment-extensions/workflows/database/examples/migration-example.md +498 -498
- package/augment-extensions/workflows/database/examples/optimization-example.md +496 -496
- package/augment-extensions/workflows/database/examples/schema-design-example.md +444 -444
- package/augment-extensions/workflows/database/module.json +42 -42
- package/augment-extensions/workflows/database/rules/data-migration.md +249 -249
- package/augment-extensions/workflows/database/rules/documentation-standards.md +339 -339
- package/augment-extensions/workflows/database/rules/migration-workflow.md +352 -352
- package/augment-extensions/workflows/database/rules/optimization-workflow.md +435 -435
- package/augment-extensions/workflows/database/rules/schema-design-workflow.md +535 -535
- package/augment-extensions/workflows/database/rules/testing-patterns.md +305 -305
- package/augment-extensions/workflows/database/rules/workflow.md +458 -458
- package/augment-extensions/workflows/wordpress-plugin/README.md +232 -232
- package/augment-extensions/workflows/wordpress-plugin/ai-prompts.md +839 -839
- package/augment-extensions/workflows/wordpress-plugin/bead-decomposition-patterns.md +854 -854
- package/augment-extensions/workflows/wordpress-plugin/examples/complete-plugin-example.md +540 -540
- package/augment-extensions/workflows/wordpress-plugin/examples/custom-post-type-example.md +1083 -1083
- package/augment-extensions/workflows/wordpress-plugin/examples/feature-addition-workflow.md +669 -669
- package/augment-extensions/workflows/wordpress-plugin/examples/plugin-creation-workflow.md +597 -597
- package/augment-extensions/workflows/wordpress-plugin/examples/secure-form-handler-example.md +925 -925
- package/augment-extensions/workflows/wordpress-plugin/examples/security-audit-workflow.md +752 -752
- package/augment-extensions/workflows/wordpress-plugin/examples/wordpress-org-submission-workflow.md +773 -773
- package/augment-extensions/workflows/wordpress-plugin/module.json +49 -49
- package/augment-extensions/workflows/wordpress-plugin/rules/best-practices.md +942 -942
- package/augment-extensions/workflows/wordpress-plugin/rules/development-workflow.md +702 -702
- package/augment-extensions/workflows/wordpress-plugin/rules/submission-workflow.md +728 -728
- package/augment-extensions/workflows/wordpress-plugin/rules/testing-workflow.md +775 -775
- package/augment-extensions/writing-standards/screenplay/README.md +339 -300
- package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -121
- package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -153
- package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -243
- package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -213
- package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain +164 -164
- package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -95
- package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -116
- package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -151
- package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -67
- package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -142
- package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -184
- package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -204
- package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -181
- package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -70
- package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -399
- package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -407
- package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -401
- package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -409
- package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -268
- package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -294
- package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -294
- package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -289
- package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -294
- package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -293
- package/augment-extensions/writing-standards/screenplay/module.json +124 -124
- package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -339
- package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -329
- package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -169
- package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -437
- package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -263
- package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -261
- package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -315
- package/augment-extensions/writing-standards/screenplay/rules/file-organization.md +213 -0
- package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -413
- package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -372
- package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -374
- package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -443
- package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -207
- package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -444
- package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -331
- package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -334
- package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -299
- package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -263
- package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -412
- package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -370
- package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -374
- package/augment-extensions/writing-standards/screenplay/rules/universal-formatting.md +339 -339
- package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -277
- package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -393
- package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -332
- package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -247
- package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -200
- package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -233
- package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -245
- package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -221
- package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -159
- package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -1449
- package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -64
- package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -520
- package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -499
- package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -497
- package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -492
- package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -509
- package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -490
- package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -499
- package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -501
- package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -499
- package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -498
- package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -499
- package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -508
- package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -500
- package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -158
- package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -643
- package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -311
- package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -562
- package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -538
- package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -432
- package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -637
- package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -66
- package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -458
- package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -490
- package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -458
- package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -459
- package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -491
- package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -491
- package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -490
- package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -464
- package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -461
- package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -489
- package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -494
- package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -483
- package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -489
- package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -496
- package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -463
- package/augment-extensions/writing-standards/screenplay/utils/__tests__/file-organization.test.ts +169 -0
- package/augment-extensions/writing-standards/screenplay/utils/file-organization.ts +165 -0
- package/cli/MODULES.md +302 -302
- package/cli/dist/cli.js +109 -22
- package/cli/dist/cli.js.map +1 -1
- package/cli/dist/commands/gui.d.ts.map +1 -1
- package/cli/dist/commands/gui.js +54 -6
- package/cli/dist/commands/gui.js.map +1 -1
- package/cli/dist/commands/init.d.ts.map +1 -1
- package/cli/dist/commands/init.js +76 -23
- package/cli/dist/commands/init.js.map +1 -1
- package/cli/dist/commands/self-remove.d.ts.map +1 -1
- package/cli/dist/commands/self-remove.js +48 -74
- package/cli/dist/commands/self-remove.js.map +1 -1
- package/cli/dist/commands/show.d.ts +11 -0
- package/cli/dist/commands/show.d.ts.map +1 -1
- package/cli/dist/commands/show.js +120 -0
- package/cli/dist/commands/show.js.map +1 -1
- package/cli/dist/commands/showCompleted.d.ts +21 -0
- package/cli/dist/commands/showCompleted.d.ts.map +1 -0
- package/cli/dist/commands/showCompleted.js +225 -0
- package/cli/dist/commands/showCompleted.js.map +1 -0
- package/cli/dist/commands/skill.js +88 -88
- package/cli/dist/commands/update.d.ts +2 -0
- package/cli/dist/commands/update.d.ts.map +1 -1
- package/cli/dist/commands/update.js +67 -1
- package/cli/dist/commands/update.js.map +1 -1
- package/cli/dist/utils/beadsCompletedChecker.d.ts +72 -0
- package/cli/dist/utils/beadsCompletedChecker.d.ts.map +1 -0
- package/cli/dist/utils/beadsCompletedChecker.js +198 -0
- package/cli/dist/utils/beadsCompletedChecker.js.map +1 -0
- package/cli/dist/utils/catalog-sync.js +13 -13
- package/cli/dist/utils/extractCommandHelp.d.ts +51 -0
- package/cli/dist/utils/extractCommandHelp.d.ts.map +1 -0
- package/cli/dist/utils/extractCommandHelp.js +250 -0
- package/cli/dist/utils/extractCommandHelp.js.map +1 -0
- package/cli/dist/utils/install-rules.js +55 -55
- package/cli/dist/utils/mcp-integration.js +44 -44
- package/cli/dist/utils/rule-install-hooks.js +8 -8
- package/modules.md +667 -630
- package/package.json +85 -85
|
@@ -1,409 +1,409 @@
|
|
|
1
|
-
# Drama Genre
|
|
2
|
-
|
|
3
|
-
**Category**: Screenplay Genre
|
|
4
|
-
**Type**: Primary
|
|
5
|
-
**Complexity**: High
|
|
6
|
-
|
|
7
|
-
## Overview
|
|
8
|
-
|
|
9
|
-
Drama films focus on realistic characters facing emotional conflicts, moral dilemmas, and personal struggles. The genre emphasizes character development, authentic relationships, and meaningful themes over spectacle or plot mechanics.
|
|
10
|
-
|
|
11
|
-
## Core Concept
|
|
12
|
-
|
|
13
|
-
Drama screenplays are built around characters confronting difficult truths, making hard choices, and experiencing genuine emotional transformation. Success depends on creating complex, believable characters, authentic dialogue, and situations that resonate with universal human experiences.
|
|
14
|
-
|
|
15
|
-
## Core Rules
|
|
16
|
-
|
|
17
|
-
### Rule 1: Character is Plot
|
|
18
|
-
|
|
19
|
-
**Description**: In drama, what happens is less important than how it affects the characters and what it reveals about them.
|
|
20
|
-
|
|
21
|
-
**Why It Matters**: Drama is character-driven. External events serve internal journeys, not vice versa.
|
|
22
|
-
|
|
23
|
-
**Examples**:
|
|
24
|
-
- ✅ **Good**: A family dinner reveals long-buried resentments and forces confrontation
|
|
25
|
-
- ❌ **Bad**: Action-packed events with no character impact or growth
|
|
26
|
-
|
|
27
|
-
**Film Reference**: Manchester by the Sea (2016) - Every plot point reveals character and deepens emotional complexity.
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
### Rule 2: Establish Authentic Emotional Stakes
|
|
32
|
-
|
|
33
|
-
**Description**: The audience must understand and care deeply about what the character stands to lose or gain emotionally.
|
|
34
|
-
|
|
35
|
-
**Why It Matters**: Without genuine emotional investment, drama becomes melodrama or feels hollow.
|
|
36
|
-
|
|
37
|
-
**Examples**:
|
|
38
|
-
- ✅ **Good**: A parent fighting to maintain relationship with their child
|
|
39
|
-
- ❌ **Bad**: Generic conflict with no emotional specificity
|
|
40
|
-
|
|
41
|
-
**Film Reference**: Kramer vs. Kramer (1979) - Custody battle grounded in authentic parental love and growth.
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
### Rule 3: Show Internal Conflict Externally
|
|
46
|
-
|
|
47
|
-
**Description**: Make internal struggles visible through behavior, choices, and dialogue rather than exposition.
|
|
48
|
-
|
|
49
|
-
**Why It Matters**: Film is a visual medium. Internal conflict must manifest in observable ways.
|
|
50
|
-
|
|
51
|
-
**Examples**:
|
|
52
|
-
- ✅ **Good**: Character's addiction shown through missed appointments, broken promises, physical deterioration
|
|
53
|
-
- ❌ **Bad**: Character tells therapist about their internal struggles in exposition-heavy scenes
|
|
54
|
-
|
|
55
|
-
**Film Reference**: Requiem for a Dream (2000) - Addiction's internal grip shown through escalating external consequences.
|
|
56
|
-
|
|
57
|
-
---
|
|
58
|
-
|
|
59
|
-
### Rule 4: Create Moral Complexity
|
|
60
|
-
|
|
61
|
-
**Description**: Avoid simple good vs. evil. Give characters understandable motivations even when they make wrong choices.
|
|
62
|
-
|
|
63
|
-
**Why It Matters**: Moral complexity creates richer drama and more realistic characters. Real people are contradictory.
|
|
64
|
-
|
|
65
|
-
**Examples**:
|
|
66
|
-
- ✅ **Good**: Antagonist has valid grievances and relatable motivations
|
|
67
|
-
- ❌ **Bad**: Villain is evil for evil's sake with no depth
|
|
68
|
-
|
|
69
|
-
**Film Reference**: There Will Be Blood (2007) - Daniel Plainview is compelling despite being morally compromised.
|
|
70
|
-
|
|
71
|
-
---
|
|
72
|
-
|
|
73
|
-
### Rule 5: Build Through Subtext
|
|
74
|
-
|
|
75
|
-
**Description**: Characters should rarely say exactly what they mean. Meaning lives beneath the surface of dialogue.
|
|
76
|
-
|
|
77
|
-
**Why It Matters**: Subtext creates depth, realism, and engagement. People in real life avoid direct confrontation.
|
|
78
|
-
|
|
79
|
-
**Examples**:
|
|
80
|
-
- ✅ **Good**: Couple argues about dishes when really discussing their failing marriage
|
|
81
|
-
- ❌ **Bad**: Characters explicitly state their feelings and motivations constantly
|
|
82
|
-
|
|
83
|
-
**Film Reference**: Revolutionary Road (2008) - Suburban pleasantries mask deep dissatisfaction and rage.
|
|
84
|
-
|
|
85
|
-
---
|
|
86
|
-
|
|
87
|
-
### Rule 6: Earn Emotional Moments
|
|
88
|
-
|
|
89
|
-
**Description**: Big emotional beats must be set up through careful character development and escalation.
|
|
90
|
-
|
|
91
|
-
**Why It Matters**: Unearned emotion feels manipulative. Audiences resent being told how to feel.
|
|
92
|
-
|
|
93
|
-
**Examples**:
|
|
94
|
-
- ✅ **Good**: Breakdown comes after accumulation of specific, relatable pressures
|
|
95
|
-
- ❌ **Bad**: Character cries in scene 3 before we know or care about them
|
|
96
|
-
|
|
97
|
-
**Film Reference**: Moonlight (2016) - Every emotional moment earned through careful character building.
|
|
98
|
-
|
|
99
|
-
---
|
|
100
|
-
|
|
101
|
-
### Rule 7: Use Specificity Over Generality
|
|
102
|
-
|
|
103
|
-
**Description**: Ground drama in specific details of time, place, culture, and character rather than generic situations.
|
|
104
|
-
|
|
105
|
-
**Why It Matters**: Specificity creates authenticity and universality. Generic feels false.
|
|
106
|
-
|
|
107
|
-
**Examples**:
|
|
108
|
-
- ✅ **Good**: Working-class Boston family with specific cultural touchstones and speech patterns
|
|
109
|
-
- ❌ **Bad**: Generic "family" with no cultural or regional identity
|
|
110
|
-
|
|
111
|
-
**Film Reference**: Fences (2016) - Specific African American experience in 1950s Pittsburgh creates universal themes.
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
115
|
-
### Rule 8: Escalate Emotional Pressure
|
|
116
|
-
|
|
117
|
-
**Description**: Each scene should increase the emotional stakes or pressure on the protagonist.
|
|
118
|
-
|
|
119
|
-
**Why It Matters**: Drama needs momentum. Flat emotional energy loses audience engagement.
|
|
120
|
-
|
|
121
|
-
**Examples**:
|
|
122
|
-
- ✅ **Good**: Small lie → bigger lie → confrontation → revelation → consequences
|
|
123
|
-
- ❌ **Bad**: Same level of conflict throughout with no escalation
|
|
124
|
-
|
|
125
|
-
**Film Reference**: A Marriage Story (2019) - Divorce proceedings escalate from civil to devastating.
|
|
126
|
-
|
|
127
|
-
---
|
|
128
|
-
|
|
129
|
-
### Rule 9: Create Moments of Grace
|
|
130
|
-
|
|
131
|
-
**Description**: Balance heavy drama with moments of beauty, humor, or human connection.
|
|
132
|
-
|
|
133
|
-
**Why It Matters**: Relentless darkness becomes numbing. Contrast makes drama more powerful.
|
|
134
|
-
|
|
135
|
-
**Examples**:
|
|
136
|
-
- ✅ **Good**: Grieving family shares a genuine laugh remembering the deceased
|
|
137
|
-
- ❌ **Bad**: Two hours of unrelenting misery with no light
|
|
138
|
-
|
|
139
|
-
**Film Reference**: The Florida Project (2017) - Childhood wonder and play amid poverty and dysfunction.
|
|
140
|
-
|
|
141
|
-
---
|
|
142
|
-
|
|
143
|
-
### Rule 10: Resolve Emotionally, Not Just Plotwise
|
|
144
|
-
|
|
145
|
-
**Description**: The ending must provide emotional resolution or meaningful change, even if plot threads remain open.
|
|
146
|
-
|
|
147
|
-
**Why It Matters**: Drama is about emotional journeys. Plot resolution without emotional payoff feels empty.
|
|
148
|
-
|
|
149
|
-
**Examples**:
|
|
150
|
-
- ✅ **Good**: Character doesn't get what they wanted but achieves understanding or acceptance
|
|
151
|
-
- ❌ **Bad**: All plot points tied up but character unchanged and unaffected
|
|
152
|
-
|
|
153
|
-
**Film Reference**: Lady Bird (2017) - Plot ends with college, but emotional resolution is mother-daughter understanding.
|
|
154
|
-
|
|
155
|
-
---
|
|
156
|
-
|
|
157
|
-
## Guidelines
|
|
158
|
-
|
|
159
|
-
### Structure
|
|
160
|
-
|
|
161
|
-
- **Act I**: Establish character's world, relationships, and internal conflict; inciting incident disrupts status quo (pages 1-25)
|
|
162
|
-
- **Act II**: Character confronts conflict, makes choices that complicate situation, relationships tested, crisis point (pages 25-85)
|
|
163
|
-
- **Act III**: Final confrontation with self or others, emotional climax, resolution or acceptance (pages 85-110)
|
|
164
|
-
|
|
165
|
-
### Pacing
|
|
166
|
-
|
|
167
|
-
- Allow scenes to breathe - drama needs time for emotional beats
|
|
168
|
-
- Build tension through character interaction, not just plot events
|
|
169
|
-
- Use quiet moments strategically
|
|
170
|
-
- Escalate emotional stakes gradually
|
|
171
|
-
- Climax should be emotional peak, not necessarily action peak
|
|
172
|
-
|
|
173
|
-
### Character Archetypes
|
|
174
|
-
|
|
175
|
-
- **Protagonist**: Flawed, complex, relatable, facing internal and external conflict
|
|
176
|
-
- **Antagonist**: Often another complex character with opposing needs (not evil villain)
|
|
177
|
-
- **Supporting**: Mirror protagonist's journey, offer contrast, or represent different choices
|
|
178
|
-
- **Confidant**: Character protagonist can be honest with (therapist, friend, mentor)
|
|
179
|
-
|
|
180
|
-
### Tone and Atmosphere
|
|
181
|
-
|
|
182
|
-
- Realistic and grounded
|
|
183
|
-
- Emotionally authentic
|
|
184
|
-
- Serious but not necessarily humorless
|
|
185
|
-
- Intimate and character-focused
|
|
186
|
-
- Subgenre-specific (family drama vs. courtroom drama vs. addiction drama)
|
|
187
|
-
|
|
188
|
-
### Visual Style
|
|
189
|
-
|
|
190
|
-
- Naturalistic lighting and cinematography
|
|
191
|
-
- Close-ups for emotional moments
|
|
192
|
-
- Environment reflects character's internal state
|
|
193
|
-
- Minimal stylization (unless serving theme)
|
|
194
|
-
- Focus on faces and reactions
|
|
195
|
-
|
|
196
|
-
### Dialogue
|
|
197
|
-
|
|
198
|
-
- Subtext-heavy
|
|
199
|
-
- Character-specific voices
|
|
200
|
-
- Realistic speech patterns (interruptions, pauses, fragments)
|
|
201
|
-
- Avoid exposition dumps
|
|
202
|
-
- What's NOT said is often more important than what is
|
|
203
|
-
|
|
204
|
-
## Common Pitfalls
|
|
205
|
-
|
|
206
|
-
### Pitfall 1: Melodrama
|
|
207
|
-
|
|
208
|
-
**Problem**: Over-the-top emotions, contrived situations, or manipulative music cues instead of earned drama.
|
|
209
|
-
|
|
210
|
-
**Solution**: Ground emotions in specific, believable circumstances. Trust the audience to feel without forcing it.
|
|
211
|
-
|
|
212
|
-
**Example**: Character's quiet devastation is more powerful than theatrical breakdown.
|
|
213
|
-
|
|
214
|
-
---
|
|
215
|
-
|
|
216
|
-
### Pitfall 2: Talking Heads
|
|
217
|
-
|
|
218
|
-
**Problem**: Scenes of people sitting and talking with no visual interest or subtext.
|
|
219
|
-
|
|
220
|
-
**Solution**: Give characters activities, use environment, create visual metaphors, employ subtext.
|
|
221
|
-
|
|
222
|
-
**Example**: Difficult conversation happens while packing boxes, cooking dinner, or walking - activity adds layers.
|
|
223
|
-
|
|
224
|
-
---
|
|
225
|
-
|
|
226
|
-
### Pitfall 3: Passive Protagonist
|
|
227
|
-
|
|
228
|
-
**Problem**: Things happen TO the character rather than the character making active choices.
|
|
229
|
-
|
|
230
|
-
**Solution**: Give protagonist agency. Even in difficult circumstances, they must make choices that drive the story.
|
|
231
|
-
|
|
232
|
-
**Example**: Character chooses to confront their past rather than being forced into it by circumstances.
|
|
233
|
-
|
|
234
|
-
---
|
|
235
|
-
|
|
236
|
-
### Pitfall 4: Unearned Resolution
|
|
237
|
-
|
|
238
|
-
**Problem**: Character suddenly changes or problem resolves without sufficient development or consequence.
|
|
239
|
-
|
|
240
|
-
**Solution**: Transformation must be gradual and hard-won. Show the work of change.
|
|
241
|
-
|
|
242
|
-
**Example**: Addict's recovery shown through specific struggles and setbacks, not sudden epiphany.
|
|
243
|
-
|
|
244
|
-
---
|
|
245
|
-
|
|
246
|
-
### Pitfall 5: Lack of Specificity
|
|
247
|
-
|
|
248
|
-
**Problem**: Generic characters in generic situations saying generic things.
|
|
249
|
-
|
|
250
|
-
**Solution**: Research, observe, and create specific details of culture, class, region, profession, era.
|
|
251
|
-
|
|
252
|
-
**Example**: Don't write "a family" - write "a second-generation Korean-American family running a laundromat in 1980s Los Angeles."
|
|
253
|
-
|
|
254
|
-
---
|
|
255
|
-
|
|
256
|
-
## Film Examples
|
|
257
|
-
|
|
258
|
-
### Example 1: Manchester by the Sea (2016)
|
|
259
|
-
|
|
260
|
-
**Director**: Kenneth Lonergan
|
|
261
|
-
|
|
262
|
-
**Why It Works**: Devastating emotional honesty, complex protagonist, authentic grief, earned moments.
|
|
263
|
-
|
|
264
|
-
**Key Scenes**:
|
|
265
|
-
- **Flashback Revelation**: Reveals Lee's trauma through carefully structured flashbacks
|
|
266
|
-
- **Hospital Confrontation**: Lee's inability to forgive himself shown through rejection of ex-wife's forgiveness
|
|
267
|
-
- **Final Scene**: Emotional resolution without false hope
|
|
268
|
-
|
|
269
|
-
**Techniques Used**:
|
|
270
|
-
- Non-linear structure reveals character gradually
|
|
271
|
-
- Subtext in every scene
|
|
272
|
-
- Humor balances grief
|
|
273
|
-
- Specific cultural and regional details
|
|
274
|
-
- Quiet devastation over melodrama
|
|
275
|
-
|
|
276
|
-
---
|
|
277
|
-
|
|
278
|
-
### Example 2: Moonlight (2016)
|
|
279
|
-
|
|
280
|
-
**Director**: Barry Jenkins
|
|
281
|
-
|
|
282
|
-
**Why It Works**: Three-act structure showing character at different life stages, visual poetry, restrained emotion.
|
|
283
|
-
|
|
284
|
-
**Key Scenes**:
|
|
285
|
-
- **Swimming Lesson**: Tenderness and mentorship
|
|
286
|
-
- **Diner Confrontation**: Chiron's transformation and suppressed emotion
|
|
287
|
-
- **Final Reunion**: Vulnerability and connection
|
|
288
|
-
|
|
289
|
-
**Techniques Used**:
|
|
290
|
-
- Triptych structure (three life stages)
|
|
291
|
-
- Visual storytelling over dialogue
|
|
292
|
-
- Specific cultural context
|
|
293
|
-
- Intimacy and restraint
|
|
294
|
-
- Color and music as emotional language
|
|
295
|
-
|
|
296
|
-
---
|
|
297
|
-
|
|
298
|
-
### Example 3: A Marriage Story (2019)
|
|
299
|
-
|
|
300
|
-
**Director**: Noah Baumbach
|
|
301
|
-
|
|
302
|
-
**Why It Works**: Authentic portrayal of divorce, complex characters both right and wrong, escalating conflict.
|
|
303
|
-
|
|
304
|
-
**Key Scenes**:
|
|
305
|
-
- **Opening Montages**: What they love about each other (never spoken aloud)
|
|
306
|
-
- **Argument Scene**: Escalation from civil to devastating
|
|
307
|
-
- **Shoe-Tying**: Small gesture of lingering care
|
|
308
|
-
|
|
309
|
-
**Techniques Used**:
|
|
310
|
-
- Dual perspective (both characters sympathetic)
|
|
311
|
-
- Escalating conflict
|
|
312
|
-
- Specific details of marriage and divorce
|
|
313
|
-
- Humor amid pain
|
|
314
|
-
- Small moments carry weight
|
|
315
|
-
|
|
316
|
-
---
|
|
317
|
-
|
|
318
|
-
### Example 4: The Florida Project (2017)
|
|
319
|
-
|
|
320
|
-
**Director**: Sean Baker
|
|
321
|
-
|
|
322
|
-
**Why It Works**: Child's perspective on poverty, beauty in hardship, non-judgmental observation.
|
|
323
|
-
|
|
324
|
-
**Key Scenes**:
|
|
325
|
-
- **Ice Cream**: Small kindness amid struggle
|
|
326
|
-
- **Final Confrontation**: Mother's desperation
|
|
327
|
-
- **Ending**: Childhood imagination as escape
|
|
328
|
-
|
|
329
|
-
**Techniques Used**:
|
|
330
|
-
- Child's POV creates distance and intimacy
|
|
331
|
-
- Vibrant colors contrast with subject matter
|
|
332
|
-
- Non-professional actors add authenticity
|
|
333
|
-
- Observational style
|
|
334
|
-
- Empathy without sentimentality
|
|
335
|
-
|
|
336
|
-
---
|
|
337
|
-
|
|
338
|
-
### Example 5: There Will Be Blood (2007)
|
|
339
|
-
|
|
340
|
-
**Director**: Paul Thomas Anderson
|
|
341
|
-
|
|
342
|
-
**Why It Works**: Epic scope with intimate character study, moral complexity, visual storytelling.
|
|
343
|
-
|
|
344
|
-
**Key Scenes**:
|
|
345
|
-
- **Opening Sequence**: Wordless character establishment
|
|
346
|
-
- **Milkshake Speech**: Culmination of rivalry and greed
|
|
347
|
-
- **Final Confrontation**: Moral degradation complete
|
|
348
|
-
|
|
349
|
-
**Techniques Used**:
|
|
350
|
-
- Visual storytelling (minimal dialogue early)
|
|
351
|
-
- Character as force of nature
|
|
352
|
-
- Historical specificity
|
|
353
|
-
- Moral complexity
|
|
354
|
-
- Operatic scope with intimate focus
|
|
355
|
-
|
|
356
|
-
---
|
|
357
|
-
|
|
358
|
-
## Integration with Other Features
|
|
359
|
-
|
|
360
|
-
### Compatible Themes
|
|
361
|
-
|
|
362
|
-
- **Redemption**: Character seeks to atone (The Wrestler)
|
|
363
|
-
- **Identity**: Character discovers or accepts self (Moonlight)
|
|
364
|
-
- **Love**: Relationships tested and transformed (Blue Valentine)
|
|
365
|
-
- **Betrayal**: Trust broken and consequences (The Godfather Part II)
|
|
366
|
-
- **Growth**: Character matures through hardship (Lady Bird)
|
|
367
|
-
|
|
368
|
-
### Compatible Styles
|
|
369
|
-
|
|
370
|
-
- **Linear**: Traditional dramatic structure (most dramas)
|
|
371
|
-
- **Non-Linear**: Flashbacks reveal character (Manchester by the Sea)
|
|
372
|
-
- **Ensemble**: Multiple character perspectives (Magnolia)
|
|
373
|
-
- **Minimalist**: Stripped-down, focused drama (45 Years)
|
|
374
|
-
|
|
375
|
-
### Hybrid Combinations
|
|
376
|
-
|
|
377
|
-
- **Courtroom Drama**: Legal framework for moral questions (A Few Good Men)
|
|
378
|
-
- **Family Drama**: Domestic conflicts (August: Osage County)
|
|
379
|
-
- **Historical Drama**: Personal stories in historical context (12 Years a Slave)
|
|
380
|
-
- **Addiction Drama**: Substance abuse and recovery (Requiem for a Dream)
|
|
381
|
-
- **Coming-of-Age Drama**: Youth and maturation (Boyhood)
|
|
382
|
-
|
|
383
|
-
## Best Practices
|
|
384
|
-
|
|
385
|
-
1. **Start with character, not plot** - Know who they are before deciding what happens
|
|
386
|
-
2. **Create specific, not generic** - Details of culture, class, region make drama universal
|
|
387
|
-
3. **Show, don't tell** - Internal conflict must manifest externally
|
|
388
|
-
4. **Earn every emotion** - Build to big moments through careful development
|
|
389
|
-
5. **Use subtext constantly** - People rarely say what they mean
|
|
390
|
-
6. **Make characters complex** - Everyone is the hero of their own story
|
|
391
|
-
7. **Balance darkness with light** - Moments of grace make drama more powerful
|
|
392
|
-
8. **Let scenes breathe** - Drama needs time for emotional beats
|
|
393
|
-
9. **Escalate emotional stakes** - Each scene should increase pressure
|
|
394
|
-
10. **Resolve emotionally** - Plot resolution without emotional payoff is empty
|
|
395
|
-
|
|
396
|
-
## Resources
|
|
397
|
-
|
|
398
|
-
- "The Art of Dramatic Writing" by Lajos Egri
|
|
399
|
-
- "Writing Drama" by Yves Lavandier
|
|
400
|
-
- "The Anatomy of Story" by John Truby
|
|
401
|
-
- "Screenplay" by Syd Field
|
|
402
|
-
- Study: Manchester by the Sea, Moonlight, A Marriage Story, The Florida Project, There Will Be Blood
|
|
403
|
-
|
|
404
|
-
---
|
|
405
|
-
|
|
406
|
-
**Depth Coverage**: 85%
|
|
407
|
-
**Last Updated**: 2026-01-31
|
|
408
|
-
**Version**: 1.0.0
|
|
409
|
-
|
|
1
|
+
# Drama Genre
|
|
2
|
+
|
|
3
|
+
**Category**: Screenplay Genre
|
|
4
|
+
**Type**: Primary
|
|
5
|
+
**Complexity**: High
|
|
6
|
+
|
|
7
|
+
## Overview
|
|
8
|
+
|
|
9
|
+
Drama films focus on realistic characters facing emotional conflicts, moral dilemmas, and personal struggles. The genre emphasizes character development, authentic relationships, and meaningful themes over spectacle or plot mechanics.
|
|
10
|
+
|
|
11
|
+
## Core Concept
|
|
12
|
+
|
|
13
|
+
Drama screenplays are built around characters confronting difficult truths, making hard choices, and experiencing genuine emotional transformation. Success depends on creating complex, believable characters, authentic dialogue, and situations that resonate with universal human experiences.
|
|
14
|
+
|
|
15
|
+
## Core Rules
|
|
16
|
+
|
|
17
|
+
### Rule 1: Character is Plot
|
|
18
|
+
|
|
19
|
+
**Description**: In drama, what happens is less important than how it affects the characters and what it reveals about them.
|
|
20
|
+
|
|
21
|
+
**Why It Matters**: Drama is character-driven. External events serve internal journeys, not vice versa.
|
|
22
|
+
|
|
23
|
+
**Examples**:
|
|
24
|
+
- ✅ **Good**: A family dinner reveals long-buried resentments and forces confrontation
|
|
25
|
+
- ❌ **Bad**: Action-packed events with no character impact or growth
|
|
26
|
+
|
|
27
|
+
**Film Reference**: Manchester by the Sea (2016) - Every plot point reveals character and deepens emotional complexity.
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
### Rule 2: Establish Authentic Emotional Stakes
|
|
32
|
+
|
|
33
|
+
**Description**: The audience must understand and care deeply about what the character stands to lose or gain emotionally.
|
|
34
|
+
|
|
35
|
+
**Why It Matters**: Without genuine emotional investment, drama becomes melodrama or feels hollow.
|
|
36
|
+
|
|
37
|
+
**Examples**:
|
|
38
|
+
- ✅ **Good**: A parent fighting to maintain relationship with their child
|
|
39
|
+
- ❌ **Bad**: Generic conflict with no emotional specificity
|
|
40
|
+
|
|
41
|
+
**Film Reference**: Kramer vs. Kramer (1979) - Custody battle grounded in authentic parental love and growth.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
### Rule 3: Show Internal Conflict Externally
|
|
46
|
+
|
|
47
|
+
**Description**: Make internal struggles visible through behavior, choices, and dialogue rather than exposition.
|
|
48
|
+
|
|
49
|
+
**Why It Matters**: Film is a visual medium. Internal conflict must manifest in observable ways.
|
|
50
|
+
|
|
51
|
+
**Examples**:
|
|
52
|
+
- ✅ **Good**: Character's addiction shown through missed appointments, broken promises, physical deterioration
|
|
53
|
+
- ❌ **Bad**: Character tells therapist about their internal struggles in exposition-heavy scenes
|
|
54
|
+
|
|
55
|
+
**Film Reference**: Requiem for a Dream (2000) - Addiction's internal grip shown through escalating external consequences.
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
### Rule 4: Create Moral Complexity
|
|
60
|
+
|
|
61
|
+
**Description**: Avoid simple good vs. evil. Give characters understandable motivations even when they make wrong choices.
|
|
62
|
+
|
|
63
|
+
**Why It Matters**: Moral complexity creates richer drama and more realistic characters. Real people are contradictory.
|
|
64
|
+
|
|
65
|
+
**Examples**:
|
|
66
|
+
- ✅ **Good**: Antagonist has valid grievances and relatable motivations
|
|
67
|
+
- ❌ **Bad**: Villain is evil for evil's sake with no depth
|
|
68
|
+
|
|
69
|
+
**Film Reference**: There Will Be Blood (2007) - Daniel Plainview is compelling despite being morally compromised.
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
### Rule 5: Build Through Subtext
|
|
74
|
+
|
|
75
|
+
**Description**: Characters should rarely say exactly what they mean. Meaning lives beneath the surface of dialogue.
|
|
76
|
+
|
|
77
|
+
**Why It Matters**: Subtext creates depth, realism, and engagement. People in real life avoid direct confrontation.
|
|
78
|
+
|
|
79
|
+
**Examples**:
|
|
80
|
+
- ✅ **Good**: Couple argues about dishes when really discussing their failing marriage
|
|
81
|
+
- ❌ **Bad**: Characters explicitly state their feelings and motivations constantly
|
|
82
|
+
|
|
83
|
+
**Film Reference**: Revolutionary Road (2008) - Suburban pleasantries mask deep dissatisfaction and rage.
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
### Rule 6: Earn Emotional Moments
|
|
88
|
+
|
|
89
|
+
**Description**: Big emotional beats must be set up through careful character development and escalation.
|
|
90
|
+
|
|
91
|
+
**Why It Matters**: Unearned emotion feels manipulative. Audiences resent being told how to feel.
|
|
92
|
+
|
|
93
|
+
**Examples**:
|
|
94
|
+
- ✅ **Good**: Breakdown comes after accumulation of specific, relatable pressures
|
|
95
|
+
- ❌ **Bad**: Character cries in scene 3 before we know or care about them
|
|
96
|
+
|
|
97
|
+
**Film Reference**: Moonlight (2016) - Every emotional moment earned through careful character building.
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
### Rule 7: Use Specificity Over Generality
|
|
102
|
+
|
|
103
|
+
**Description**: Ground drama in specific details of time, place, culture, and character rather than generic situations.
|
|
104
|
+
|
|
105
|
+
**Why It Matters**: Specificity creates authenticity and universality. Generic feels false.
|
|
106
|
+
|
|
107
|
+
**Examples**:
|
|
108
|
+
- ✅ **Good**: Working-class Boston family with specific cultural touchstones and speech patterns
|
|
109
|
+
- ❌ **Bad**: Generic "family" with no cultural or regional identity
|
|
110
|
+
|
|
111
|
+
**Film Reference**: Fences (2016) - Specific African American experience in 1950s Pittsburgh creates universal themes.
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
### Rule 8: Escalate Emotional Pressure
|
|
116
|
+
|
|
117
|
+
**Description**: Each scene should increase the emotional stakes or pressure on the protagonist.
|
|
118
|
+
|
|
119
|
+
**Why It Matters**: Drama needs momentum. Flat emotional energy loses audience engagement.
|
|
120
|
+
|
|
121
|
+
**Examples**:
|
|
122
|
+
- ✅ **Good**: Small lie → bigger lie → confrontation → revelation → consequences
|
|
123
|
+
- ❌ **Bad**: Same level of conflict throughout with no escalation
|
|
124
|
+
|
|
125
|
+
**Film Reference**: A Marriage Story (2019) - Divorce proceedings escalate from civil to devastating.
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
### Rule 9: Create Moments of Grace
|
|
130
|
+
|
|
131
|
+
**Description**: Balance heavy drama with moments of beauty, humor, or human connection.
|
|
132
|
+
|
|
133
|
+
**Why It Matters**: Relentless darkness becomes numbing. Contrast makes drama more powerful.
|
|
134
|
+
|
|
135
|
+
**Examples**:
|
|
136
|
+
- ✅ **Good**: Grieving family shares a genuine laugh remembering the deceased
|
|
137
|
+
- ❌ **Bad**: Two hours of unrelenting misery with no light
|
|
138
|
+
|
|
139
|
+
**Film Reference**: The Florida Project (2017) - Childhood wonder and play amid poverty and dysfunction.
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
### Rule 10: Resolve Emotionally, Not Just Plotwise
|
|
144
|
+
|
|
145
|
+
**Description**: The ending must provide emotional resolution or meaningful change, even if plot threads remain open.
|
|
146
|
+
|
|
147
|
+
**Why It Matters**: Drama is about emotional journeys. Plot resolution without emotional payoff feels empty.
|
|
148
|
+
|
|
149
|
+
**Examples**:
|
|
150
|
+
- ✅ **Good**: Character doesn't get what they wanted but achieves understanding or acceptance
|
|
151
|
+
- ❌ **Bad**: All plot points tied up but character unchanged and unaffected
|
|
152
|
+
|
|
153
|
+
**Film Reference**: Lady Bird (2017) - Plot ends with college, but emotional resolution is mother-daughter understanding.
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
## Guidelines
|
|
158
|
+
|
|
159
|
+
### Structure
|
|
160
|
+
|
|
161
|
+
- **Act I**: Establish character's world, relationships, and internal conflict; inciting incident disrupts status quo (pages 1-25)
|
|
162
|
+
- **Act II**: Character confronts conflict, makes choices that complicate situation, relationships tested, crisis point (pages 25-85)
|
|
163
|
+
- **Act III**: Final confrontation with self or others, emotional climax, resolution or acceptance (pages 85-110)
|
|
164
|
+
|
|
165
|
+
### Pacing
|
|
166
|
+
|
|
167
|
+
- Allow scenes to breathe - drama needs time for emotional beats
|
|
168
|
+
- Build tension through character interaction, not just plot events
|
|
169
|
+
- Use quiet moments strategically
|
|
170
|
+
- Escalate emotional stakes gradually
|
|
171
|
+
- Climax should be emotional peak, not necessarily action peak
|
|
172
|
+
|
|
173
|
+
### Character Archetypes
|
|
174
|
+
|
|
175
|
+
- **Protagonist**: Flawed, complex, relatable, facing internal and external conflict
|
|
176
|
+
- **Antagonist**: Often another complex character with opposing needs (not evil villain)
|
|
177
|
+
- **Supporting**: Mirror protagonist's journey, offer contrast, or represent different choices
|
|
178
|
+
- **Confidant**: Character protagonist can be honest with (therapist, friend, mentor)
|
|
179
|
+
|
|
180
|
+
### Tone and Atmosphere
|
|
181
|
+
|
|
182
|
+
- Realistic and grounded
|
|
183
|
+
- Emotionally authentic
|
|
184
|
+
- Serious but not necessarily humorless
|
|
185
|
+
- Intimate and character-focused
|
|
186
|
+
- Subgenre-specific (family drama vs. courtroom drama vs. addiction drama)
|
|
187
|
+
|
|
188
|
+
### Visual Style
|
|
189
|
+
|
|
190
|
+
- Naturalistic lighting and cinematography
|
|
191
|
+
- Close-ups for emotional moments
|
|
192
|
+
- Environment reflects character's internal state
|
|
193
|
+
- Minimal stylization (unless serving theme)
|
|
194
|
+
- Focus on faces and reactions
|
|
195
|
+
|
|
196
|
+
### Dialogue
|
|
197
|
+
|
|
198
|
+
- Subtext-heavy
|
|
199
|
+
- Character-specific voices
|
|
200
|
+
- Realistic speech patterns (interruptions, pauses, fragments)
|
|
201
|
+
- Avoid exposition dumps
|
|
202
|
+
- What's NOT said is often more important than what is
|
|
203
|
+
|
|
204
|
+
## Common Pitfalls
|
|
205
|
+
|
|
206
|
+
### Pitfall 1: Melodrama
|
|
207
|
+
|
|
208
|
+
**Problem**: Over-the-top emotions, contrived situations, or manipulative music cues instead of earned drama.
|
|
209
|
+
|
|
210
|
+
**Solution**: Ground emotions in specific, believable circumstances. Trust the audience to feel without forcing it.
|
|
211
|
+
|
|
212
|
+
**Example**: Character's quiet devastation is more powerful than theatrical breakdown.
|
|
213
|
+
|
|
214
|
+
---
|
|
215
|
+
|
|
216
|
+
### Pitfall 2: Talking Heads
|
|
217
|
+
|
|
218
|
+
**Problem**: Scenes of people sitting and talking with no visual interest or subtext.
|
|
219
|
+
|
|
220
|
+
**Solution**: Give characters activities, use environment, create visual metaphors, employ subtext.
|
|
221
|
+
|
|
222
|
+
**Example**: Difficult conversation happens while packing boxes, cooking dinner, or walking - activity adds layers.
|
|
223
|
+
|
|
224
|
+
---
|
|
225
|
+
|
|
226
|
+
### Pitfall 3: Passive Protagonist
|
|
227
|
+
|
|
228
|
+
**Problem**: Things happen TO the character rather than the character making active choices.
|
|
229
|
+
|
|
230
|
+
**Solution**: Give protagonist agency. Even in difficult circumstances, they must make choices that drive the story.
|
|
231
|
+
|
|
232
|
+
**Example**: Character chooses to confront their past rather than being forced into it by circumstances.
|
|
233
|
+
|
|
234
|
+
---
|
|
235
|
+
|
|
236
|
+
### Pitfall 4: Unearned Resolution
|
|
237
|
+
|
|
238
|
+
**Problem**: Character suddenly changes or problem resolves without sufficient development or consequence.
|
|
239
|
+
|
|
240
|
+
**Solution**: Transformation must be gradual and hard-won. Show the work of change.
|
|
241
|
+
|
|
242
|
+
**Example**: Addict's recovery shown through specific struggles and setbacks, not sudden epiphany.
|
|
243
|
+
|
|
244
|
+
---
|
|
245
|
+
|
|
246
|
+
### Pitfall 5: Lack of Specificity
|
|
247
|
+
|
|
248
|
+
**Problem**: Generic characters in generic situations saying generic things.
|
|
249
|
+
|
|
250
|
+
**Solution**: Research, observe, and create specific details of culture, class, region, profession, era.
|
|
251
|
+
|
|
252
|
+
**Example**: Don't write "a family" - write "a second-generation Korean-American family running a laundromat in 1980s Los Angeles."
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
## Film Examples
|
|
257
|
+
|
|
258
|
+
### Example 1: Manchester by the Sea (2016)
|
|
259
|
+
|
|
260
|
+
**Director**: Kenneth Lonergan
|
|
261
|
+
|
|
262
|
+
**Why It Works**: Devastating emotional honesty, complex protagonist, authentic grief, earned moments.
|
|
263
|
+
|
|
264
|
+
**Key Scenes**:
|
|
265
|
+
- **Flashback Revelation**: Reveals Lee's trauma through carefully structured flashbacks
|
|
266
|
+
- **Hospital Confrontation**: Lee's inability to forgive himself shown through rejection of ex-wife's forgiveness
|
|
267
|
+
- **Final Scene**: Emotional resolution without false hope
|
|
268
|
+
|
|
269
|
+
**Techniques Used**:
|
|
270
|
+
- Non-linear structure reveals character gradually
|
|
271
|
+
- Subtext in every scene
|
|
272
|
+
- Humor balances grief
|
|
273
|
+
- Specific cultural and regional details
|
|
274
|
+
- Quiet devastation over melodrama
|
|
275
|
+
|
|
276
|
+
---
|
|
277
|
+
|
|
278
|
+
### Example 2: Moonlight (2016)
|
|
279
|
+
|
|
280
|
+
**Director**: Barry Jenkins
|
|
281
|
+
|
|
282
|
+
**Why It Works**: Three-act structure showing character at different life stages, visual poetry, restrained emotion.
|
|
283
|
+
|
|
284
|
+
**Key Scenes**:
|
|
285
|
+
- **Swimming Lesson**: Tenderness and mentorship
|
|
286
|
+
- **Diner Confrontation**: Chiron's transformation and suppressed emotion
|
|
287
|
+
- **Final Reunion**: Vulnerability and connection
|
|
288
|
+
|
|
289
|
+
**Techniques Used**:
|
|
290
|
+
- Triptych structure (three life stages)
|
|
291
|
+
- Visual storytelling over dialogue
|
|
292
|
+
- Specific cultural context
|
|
293
|
+
- Intimacy and restraint
|
|
294
|
+
- Color and music as emotional language
|
|
295
|
+
|
|
296
|
+
---
|
|
297
|
+
|
|
298
|
+
### Example 3: A Marriage Story (2019)
|
|
299
|
+
|
|
300
|
+
**Director**: Noah Baumbach
|
|
301
|
+
|
|
302
|
+
**Why It Works**: Authentic portrayal of divorce, complex characters both right and wrong, escalating conflict.
|
|
303
|
+
|
|
304
|
+
**Key Scenes**:
|
|
305
|
+
- **Opening Montages**: What they love about each other (never spoken aloud)
|
|
306
|
+
- **Argument Scene**: Escalation from civil to devastating
|
|
307
|
+
- **Shoe-Tying**: Small gesture of lingering care
|
|
308
|
+
|
|
309
|
+
**Techniques Used**:
|
|
310
|
+
- Dual perspective (both characters sympathetic)
|
|
311
|
+
- Escalating conflict
|
|
312
|
+
- Specific details of marriage and divorce
|
|
313
|
+
- Humor amid pain
|
|
314
|
+
- Small moments carry weight
|
|
315
|
+
|
|
316
|
+
---
|
|
317
|
+
|
|
318
|
+
### Example 4: The Florida Project (2017)
|
|
319
|
+
|
|
320
|
+
**Director**: Sean Baker
|
|
321
|
+
|
|
322
|
+
**Why It Works**: Child's perspective on poverty, beauty in hardship, non-judgmental observation.
|
|
323
|
+
|
|
324
|
+
**Key Scenes**:
|
|
325
|
+
- **Ice Cream**: Small kindness amid struggle
|
|
326
|
+
- **Final Confrontation**: Mother's desperation
|
|
327
|
+
- **Ending**: Childhood imagination as escape
|
|
328
|
+
|
|
329
|
+
**Techniques Used**:
|
|
330
|
+
- Child's POV creates distance and intimacy
|
|
331
|
+
- Vibrant colors contrast with subject matter
|
|
332
|
+
- Non-professional actors add authenticity
|
|
333
|
+
- Observational style
|
|
334
|
+
- Empathy without sentimentality
|
|
335
|
+
|
|
336
|
+
---
|
|
337
|
+
|
|
338
|
+
### Example 5: There Will Be Blood (2007)
|
|
339
|
+
|
|
340
|
+
**Director**: Paul Thomas Anderson
|
|
341
|
+
|
|
342
|
+
**Why It Works**: Epic scope with intimate character study, moral complexity, visual storytelling.
|
|
343
|
+
|
|
344
|
+
**Key Scenes**:
|
|
345
|
+
- **Opening Sequence**: Wordless character establishment
|
|
346
|
+
- **Milkshake Speech**: Culmination of rivalry and greed
|
|
347
|
+
- **Final Confrontation**: Moral degradation complete
|
|
348
|
+
|
|
349
|
+
**Techniques Used**:
|
|
350
|
+
- Visual storytelling (minimal dialogue early)
|
|
351
|
+
- Character as force of nature
|
|
352
|
+
- Historical specificity
|
|
353
|
+
- Moral complexity
|
|
354
|
+
- Operatic scope with intimate focus
|
|
355
|
+
|
|
356
|
+
---
|
|
357
|
+
|
|
358
|
+
## Integration with Other Features
|
|
359
|
+
|
|
360
|
+
### Compatible Themes
|
|
361
|
+
|
|
362
|
+
- **Redemption**: Character seeks to atone (The Wrestler)
|
|
363
|
+
- **Identity**: Character discovers or accepts self (Moonlight)
|
|
364
|
+
- **Love**: Relationships tested and transformed (Blue Valentine)
|
|
365
|
+
- **Betrayal**: Trust broken and consequences (The Godfather Part II)
|
|
366
|
+
- **Growth**: Character matures through hardship (Lady Bird)
|
|
367
|
+
|
|
368
|
+
### Compatible Styles
|
|
369
|
+
|
|
370
|
+
- **Linear**: Traditional dramatic structure (most dramas)
|
|
371
|
+
- **Non-Linear**: Flashbacks reveal character (Manchester by the Sea)
|
|
372
|
+
- **Ensemble**: Multiple character perspectives (Magnolia)
|
|
373
|
+
- **Minimalist**: Stripped-down, focused drama (45 Years)
|
|
374
|
+
|
|
375
|
+
### Hybrid Combinations
|
|
376
|
+
|
|
377
|
+
- **Courtroom Drama**: Legal framework for moral questions (A Few Good Men)
|
|
378
|
+
- **Family Drama**: Domestic conflicts (August: Osage County)
|
|
379
|
+
- **Historical Drama**: Personal stories in historical context (12 Years a Slave)
|
|
380
|
+
- **Addiction Drama**: Substance abuse and recovery (Requiem for a Dream)
|
|
381
|
+
- **Coming-of-Age Drama**: Youth and maturation (Boyhood)
|
|
382
|
+
|
|
383
|
+
## Best Practices
|
|
384
|
+
|
|
385
|
+
1. **Start with character, not plot** - Know who they are before deciding what happens
|
|
386
|
+
2. **Create specific, not generic** - Details of culture, class, region make drama universal
|
|
387
|
+
3. **Show, don't tell** - Internal conflict must manifest externally
|
|
388
|
+
4. **Earn every emotion** - Build to big moments through careful development
|
|
389
|
+
5. **Use subtext constantly** - People rarely say what they mean
|
|
390
|
+
6. **Make characters complex** - Everyone is the hero of their own story
|
|
391
|
+
7. **Balance darkness with light** - Moments of grace make drama more powerful
|
|
392
|
+
8. **Let scenes breathe** - Drama needs time for emotional beats
|
|
393
|
+
9. **Escalate emotional stakes** - Each scene should increase pressure
|
|
394
|
+
10. **Resolve emotionally** - Plot resolution without emotional payoff is empty
|
|
395
|
+
|
|
396
|
+
## Resources
|
|
397
|
+
|
|
398
|
+
- "The Art of Dramatic Writing" by Lajos Egri
|
|
399
|
+
- "Writing Drama" by Yves Lavandier
|
|
400
|
+
- "The Anatomy of Story" by John Truby
|
|
401
|
+
- "Screenplay" by Syd Field
|
|
402
|
+
- Study: Manchester by the Sea, Moonlight, A Marriage Story, The Florida Project, There Will Be Blood
|
|
403
|
+
|
|
404
|
+
---
|
|
405
|
+
|
|
406
|
+
**Depth Coverage**: 85%
|
|
407
|
+
**Last Updated**: 2026-01-31
|
|
408
|
+
**Version**: 1.0.0
|
|
409
|
+
|