@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,401 +1,401 @@
|
|
|
1
|
-
# Comedy Genre
|
|
2
|
-
|
|
3
|
-
**Category**: Screenplay Genre
|
|
4
|
-
**Type**: Primary
|
|
5
|
-
**Complexity**: High
|
|
6
|
-
|
|
7
|
-
## Overview
|
|
8
|
-
|
|
9
|
-
Comedy films prioritize humor, laughter, and entertainment through wit, physical gags, situational irony, and character-based humor. The genre emphasizes timing, surprise, and the subversion of expectations.
|
|
10
|
-
|
|
11
|
-
## Core Concept
|
|
12
|
-
|
|
13
|
-
Comedy screenplays are built around creating laughter through character flaws, misunderstandings, absurd situations, or clever wordplay. Success depends on establishing a comedic tone early, maintaining consistent logic within the absurdity, and balancing humor with genuine emotion or stakes.
|
|
14
|
-
|
|
15
|
-
## Core Rules
|
|
16
|
-
|
|
17
|
-
### Rule 1: Establish the Comedic Tone Immediately
|
|
18
|
-
|
|
19
|
-
**Description**: The first 5-10 pages must signal to the audience what kind of comedy this is and what to expect.
|
|
20
|
-
|
|
21
|
-
**Why It Matters**: Audiences need to calibrate their expectations. Tonal confusion kills comedy.
|
|
22
|
-
|
|
23
|
-
**Examples**:
|
|
24
|
-
- ✅ **Good**: Opening scene demonstrates the specific type of humor (slapstick, witty banter, awkward situations)
|
|
25
|
-
- ❌ **Bad**: First 20 pages are serious drama, then comedy appears randomly
|
|
26
|
-
|
|
27
|
-
**Film Reference**: Airplane! (1980) - Absurdist humor established in the first minute.
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
### Rule 2: Comedy Comes from Character
|
|
32
|
-
|
|
33
|
-
**Description**: The funniest moments arise from characters behaving consistently with their established personalities, not from random jokes.
|
|
34
|
-
|
|
35
|
-
**Why It Matters**: Character-based comedy is sustainable and emotionally resonant. Random jokes feel disconnected.
|
|
36
|
-
|
|
37
|
-
**Examples**:
|
|
38
|
-
- ✅ **Good**: Uptight character's rigid behavior creates humor in chaotic situations
|
|
39
|
-
- ❌ **Bad**: Characters act out of character just to deliver a punchline
|
|
40
|
-
|
|
41
|
-
**Film Reference**: The Big Lebowski (1998) - The Dude's laid-back personality creates humor in every situation.
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
### Rule 3: Rule of Three
|
|
46
|
-
|
|
47
|
-
**Description**: Comedic patterns work best in threes - setup, reinforcement, payoff/subversion.
|
|
48
|
-
|
|
49
|
-
**Why It Matters**: Two is predictable, four is repetitive. Three is the sweet spot for comedic rhythm.
|
|
50
|
-
|
|
51
|
-
**Examples**:
|
|
52
|
-
- ✅ **Good**: Character fails twice in similar ways, third attempt succeeds in unexpected manner
|
|
53
|
-
- ❌ **Bad**: Same joke repeated five times with no variation
|
|
54
|
-
|
|
55
|
-
**Film Reference**: Hot Fuzz (2007) - "The greater good" repeated three times for comedic effect.
|
|
56
|
-
|
|
57
|
-
---
|
|
58
|
-
|
|
59
|
-
### Rule 4: Escalate the Absurdity
|
|
60
|
-
|
|
61
|
-
**Description**: Each comedic set piece should be more outrageous than the last, while maintaining internal logic.
|
|
62
|
-
|
|
63
|
-
**Why It Matters**: Escalation maintains energy and prevents the comedy from feeling flat or repetitive.
|
|
64
|
-
|
|
65
|
-
**Examples**:
|
|
66
|
-
- ✅ **Good**: Small lie → bigger lie to cover first lie → elaborate scheme to maintain lies → complete chaos
|
|
67
|
-
- ❌ **Bad**: Same level of absurdity throughout with no escalation
|
|
68
|
-
|
|
69
|
-
**Film Reference**: Liar Liar (1997) - Jim Carrey's inability to lie escalates from minor to catastrophic.
|
|
70
|
-
|
|
71
|
-
---
|
|
72
|
-
|
|
73
|
-
### Rule 5: Subvert Expectations
|
|
74
|
-
|
|
75
|
-
**Description**: Set up audience expectations, then deliver something unexpected but logical in hindsight.
|
|
76
|
-
|
|
77
|
-
**Why It Matters**: Surprise is essential to comedy. Predictable jokes aren't funny.
|
|
78
|
-
|
|
79
|
-
**Examples**:
|
|
80
|
-
- ✅ **Good**: Setup suggests one outcome, deliver a different but equally logical outcome
|
|
81
|
-
- ❌ **Bad**: Telegraphed punchlines the audience sees coming
|
|
82
|
-
|
|
83
|
-
**Film Reference**: Monty Python and the Holy Grail (1975) - Constant subversion of medieval epic expectations.
|
|
84
|
-
|
|
85
|
-
---
|
|
86
|
-
|
|
87
|
-
### Rule 6: Ground Comedy in Truth
|
|
88
|
-
|
|
89
|
-
**Description**: Even absurd comedy should be rooted in recognizable human behavior, emotions, or situations.
|
|
90
|
-
|
|
91
|
-
**Why It Matters**: Audiences connect with truth. Grounded comedy is more relatable and sustainable.
|
|
92
|
-
|
|
93
|
-
**Examples**:
|
|
94
|
-
- ✅ **Good**: Exaggerated version of real awkward social situations
|
|
95
|
-
- ❌ **Bad**: Random absurdity with no connection to reality
|
|
96
|
-
|
|
97
|
-
**Film Reference**: The Office (2005-2013) - Workplace comedy grounded in real office dynamics.
|
|
98
|
-
|
|
99
|
-
---
|
|
100
|
-
|
|
101
|
-
### Rule 7: Timing is Everything
|
|
102
|
-
|
|
103
|
-
**Description**: Comedic beats need proper setup, breathing room, and precise delivery timing on the page.
|
|
104
|
-
|
|
105
|
-
**Why It Matters**: Rushed or poorly timed jokes fall flat. White space and pacing create rhythm.
|
|
106
|
-
|
|
107
|
-
**Examples**:
|
|
108
|
-
- ✅ **Good**: Setup... brief pause... punchline. New paragraph for reaction.
|
|
109
|
-
- ❌ **Bad**: Setup and punchline crammed together with no breathing room
|
|
110
|
-
|
|
111
|
-
**Film Reference**: Arrested Development (2003-2019) - Masterful comedic timing and callbacks.
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
115
|
-
### Rule 8: Create Comedic Conflict
|
|
116
|
-
|
|
117
|
-
**Description**: Comedy should arise from genuine conflict between characters, goals, or values.
|
|
118
|
-
|
|
119
|
-
**Why It Matters**: Conflict creates stakes and makes the comedy meaningful, not just random gags.
|
|
120
|
-
|
|
121
|
-
**Examples**:
|
|
122
|
-
- ✅ **Good**: Two characters with opposing goals forced to work together
|
|
123
|
-
- ❌ **Bad**: Characters tell jokes at each other with no real conflict
|
|
124
|
-
|
|
125
|
-
**Film Reference**: The Odd Couple (1968) - Conflict between neat freak and slob drives all comedy.
|
|
126
|
-
|
|
127
|
-
---
|
|
128
|
-
|
|
129
|
-
### Rule 9: Balance Humor with Heart
|
|
130
|
-
|
|
131
|
-
**Description**: Audiences need to care about characters and outcomes, not just laugh at them.
|
|
132
|
-
|
|
133
|
-
**Why It Matters**: Pure mockery becomes mean. Emotional investment makes comedy more satisfying.
|
|
134
|
-
|
|
135
|
-
**Examples**:
|
|
136
|
-
- ✅ **Good**: We laugh with characters we care about, not just at them
|
|
137
|
-
- ❌ **Bad**: Characters are punching bags with no depth or sympathy
|
|
138
|
-
|
|
139
|
-
**Film Reference**: Groundhog Day (1993) - Bill Murray's character growth gives comedy emotional weight.
|
|
140
|
-
|
|
141
|
-
---
|
|
142
|
-
|
|
143
|
-
### Rule 10: Maintain Internal Logic
|
|
144
|
-
|
|
145
|
-
**Description**: Even in absurd comedy, the world must follow its own established rules consistently.
|
|
146
|
-
|
|
147
|
-
**Why It Matters**: Inconsistent logic feels lazy. Consistent absurdity is funnier.
|
|
148
|
-
|
|
149
|
-
**Examples**:
|
|
150
|
-
- ✅ **Good**: If magic exists, it follows specific rules that create comedic situations
|
|
151
|
-
- ❌ **Bad**: Rules change based on what's convenient for the joke
|
|
152
|
-
|
|
153
|
-
**Film Reference**: Ghostbusters (1984) - Supernatural elements follow consistent rules that enable comedy.
|
|
154
|
-
|
|
155
|
-
---
|
|
156
|
-
|
|
157
|
-
## Guidelines
|
|
158
|
-
|
|
159
|
-
### Structure
|
|
160
|
-
|
|
161
|
-
- **Act I**: Establish comedic tone, introduce flawed protagonist, inciting incident creates comedic situation (pages 1-25)
|
|
162
|
-
- **Act II**: Escalating comedic complications, character's flaws make things worse, false victory, all seems lost (pages 25-85)
|
|
163
|
-
- **Act III**: Final comedic set piece, character growth resolves situation, emotional payoff (pages 85-110)
|
|
164
|
-
|
|
165
|
-
### Pacing
|
|
166
|
-
|
|
167
|
-
- Joke or comedic moment every page (at minimum)
|
|
168
|
-
- Major comedic set piece every 10-15 pages
|
|
169
|
-
- Vary joke types (verbal, physical, situational, character-based)
|
|
170
|
-
- Allow brief emotional beats between major comedic sequences
|
|
171
|
-
- Build to biggest laugh in climax
|
|
172
|
-
|
|
173
|
-
### Character Archetypes
|
|
174
|
-
|
|
175
|
-
- **Protagonist**: Flawed but likable, often oblivious to their own ridiculousness
|
|
176
|
-
- **Straight Man**: Reacts to absurdity, grounds the comedy
|
|
177
|
-
- **Comic Relief**: Intentionally funny character (use sparingly in comedy - everyone should be funny)
|
|
178
|
-
- **Antagonist**: Often uptight, rigid, or representing what protagonist must overcome
|
|
179
|
-
|
|
180
|
-
### Tone and Atmosphere
|
|
181
|
-
|
|
182
|
-
- Consistent comedic voice throughout
|
|
183
|
-
- Optimistic and playful
|
|
184
|
-
- Self-aware without being meta (unless that's the style)
|
|
185
|
-
- Energetic pacing
|
|
186
|
-
- Subgenre-specific (slapstick vs. witty vs. dark comedy)
|
|
187
|
-
|
|
188
|
-
### Visual Style
|
|
189
|
-
|
|
190
|
-
- Physical comedy requires clear staging
|
|
191
|
-
- Reaction shots are crucial
|
|
192
|
-
- Visual gags in background
|
|
193
|
-
- Exaggerated but readable expressions
|
|
194
|
-
- Timing indicated through white space and formatting
|
|
195
|
-
|
|
196
|
-
### Dialogue
|
|
197
|
-
|
|
198
|
-
- Wit and wordplay
|
|
199
|
-
- Subtext and irony
|
|
200
|
-
- Callbacks and running gags
|
|
201
|
-
- Rhythm and musicality
|
|
202
|
-
- Character-specific speech patterns that create humor
|
|
203
|
-
|
|
204
|
-
## Common Pitfalls
|
|
205
|
-
|
|
206
|
-
### Pitfall 1: Jokes Without Story
|
|
207
|
-
|
|
208
|
-
**Problem**: String of unconnected gags with no narrative throughline.
|
|
209
|
-
|
|
210
|
-
**Solution**: Every joke should serve character or plot. Comedy enhances story, doesn't replace it.
|
|
211
|
-
|
|
212
|
-
**Example**: Jokes arise from character trying to achieve their goal, not random asides.
|
|
213
|
-
|
|
214
|
-
---
|
|
215
|
-
|
|
216
|
-
### Pitfall 2: Mean-Spirited Humor
|
|
217
|
-
|
|
218
|
-
**Problem**: Laughing at characters' pain without empathy or growth.
|
|
219
|
-
|
|
220
|
-
**Solution**: Make characters sympathetic. Earn the right to mock them by making them human first.
|
|
221
|
-
|
|
222
|
-
**Example**: We laugh at their mistakes because we relate, not because we're cruel.
|
|
223
|
-
|
|
224
|
-
---
|
|
225
|
-
|
|
226
|
-
### Pitfall 3: Explaining the Joke
|
|
227
|
-
|
|
228
|
-
**Problem**: Characters or narration explain why something is funny.
|
|
229
|
-
|
|
230
|
-
**Solution**: Trust the audience. If a joke needs explanation, it's not working.
|
|
231
|
-
|
|
232
|
-
**Example**: Let the situation speak for itself. Cut any line that says "That's funny because..."
|
|
233
|
-
|
|
234
|
-
---
|
|
235
|
-
|
|
236
|
-
### Pitfall 4: Inconsistent Tone
|
|
237
|
-
|
|
238
|
-
**Problem**: Shifting between comedy styles or mixing comedy with drama clumsily.
|
|
239
|
-
|
|
240
|
-
**Solution**: Establish your comedic voice early and maintain it. Emotional moments should feel earned, not jarring.
|
|
241
|
-
|
|
242
|
-
**Example**: Dramedy requires careful balance - don't undercut serious moments with inappropriate jokes.
|
|
243
|
-
|
|
244
|
-
---
|
|
245
|
-
|
|
246
|
-
### Pitfall 5: Relying on References
|
|
247
|
-
|
|
248
|
-
**Problem**: Jokes depend entirely on pop culture references that will date quickly.
|
|
249
|
-
|
|
250
|
-
**Solution**: Use references sparingly. Focus on character and situation-based humor that's timeless.
|
|
251
|
-
|
|
252
|
-
**Example**: Character-based humor from Groundhog Day still works decades later; topical references from 1993 don't.
|
|
253
|
-
|
|
254
|
-
---
|
|
255
|
-
|
|
256
|
-
## Film Examples
|
|
257
|
-
|
|
258
|
-
### Example 1: Groundhog Day (1993)
|
|
259
|
-
|
|
260
|
-
**Director**: Harold Ramis
|
|
261
|
-
|
|
262
|
-
**Why It Works**: High-concept premise, character growth, perfect balance of humor and heart.
|
|
263
|
-
|
|
264
|
-
**Key Scenes**:
|
|
265
|
-
- **First Loop**: Establishes the comedic premise
|
|
266
|
-
- **Montage of Attempts**: Escalating absurdity as Phil tries different approaches
|
|
267
|
-
- **Piano Lesson**: Emotional depth beneath the comedy
|
|
268
|
-
|
|
269
|
-
**Techniques Used**:
|
|
270
|
-
- Repetition with variation
|
|
271
|
-
- Character transformation through comedy
|
|
272
|
-
- Grounded fantasy premise
|
|
273
|
-
- Emotional payoff
|
|
274
|
-
|
|
275
|
-
---
|
|
276
|
-
|
|
277
|
-
### Example 2: The Big Lebowski (1998)
|
|
278
|
-
|
|
279
|
-
**Director**: Joel and Ethan Coen
|
|
280
|
-
|
|
281
|
-
**Why It Works**: Unique characters, quotable dialogue, absurd situations grounded in character.
|
|
282
|
-
|
|
283
|
-
**Key Scenes**:
|
|
284
|
-
- **Rug Peed On**: Inciting incident is perfectly absurd
|
|
285
|
-
- **Bowling Alley**: Character dynamics create constant humor
|
|
286
|
-
- **Dream Sequence**: Surreal comedy that fits the tone
|
|
287
|
-
|
|
288
|
-
**Techniques Used**:
|
|
289
|
-
- Character-based humor
|
|
290
|
-
- Quotable dialogue
|
|
291
|
-
- Absurdist situations
|
|
292
|
-
- Consistent tone
|
|
293
|
-
|
|
294
|
-
---
|
|
295
|
-
|
|
296
|
-
### Example 3: Airplane! (1980)
|
|
297
|
-
|
|
298
|
-
**Director**: Jim Abrahams, David Zucker, Jerry Zucker
|
|
299
|
-
|
|
300
|
-
**Why It Works**: Rapid-fire jokes, visual gags, parody done right, commitment to absurdity.
|
|
301
|
-
|
|
302
|
-
**Key Scenes**:
|
|
303
|
-
- **"Don't call me Shirley"**: Wordplay and deadpan delivery
|
|
304
|
-
- **Autopilot**: Visual gag taken to extreme
|
|
305
|
-
- **"I picked the wrong week to quit smoking"**: Running gag escalation
|
|
306
|
-
|
|
307
|
-
**Techniques Used**:
|
|
308
|
-
- Joke density (multiple jokes per page)
|
|
309
|
-
- Deadpan delivery of absurdity
|
|
310
|
-
- Visual and verbal gags layered
|
|
311
|
-
- Parody with love for source material
|
|
312
|
-
|
|
313
|
-
---
|
|
314
|
-
|
|
315
|
-
### Example 4: Bridesmaids (2011)
|
|
316
|
-
|
|
317
|
-
**Director**: Paul Feig
|
|
318
|
-
|
|
319
|
-
**Why It Works**: Female-driven comedy, emotional authenticity, mix of crude and heartfelt humor.
|
|
320
|
-
|
|
321
|
-
**Key Scenes**:
|
|
322
|
-
- **Bridal Shop Food Poisoning**: Physical comedy with character stakes
|
|
323
|
-
- **Airplane Freakout**: Escalating absurdity from character flaw
|
|
324
|
-
- **Reconciliation**: Emotional payoff earned through comedy
|
|
325
|
-
|
|
326
|
-
**Techniques Used**:
|
|
327
|
-
- Character flaws drive comedy
|
|
328
|
-
- Balance crude and sweet
|
|
329
|
-
- Female friendship as foundation
|
|
330
|
-
- Emotional stakes
|
|
331
|
-
|
|
332
|
-
---
|
|
333
|
-
|
|
334
|
-
### Example 5: Hot Fuzz (2007)
|
|
335
|
-
|
|
336
|
-
**Director**: Edgar Wright
|
|
337
|
-
|
|
338
|
-
**Why It Works**: Genre parody, visual comedy, tight plotting, callbacks and payoffs.
|
|
339
|
-
|
|
340
|
-
**Key Scenes**:
|
|
341
|
-
- **Paperwork Montage**: Action movie editing for mundane tasks
|
|
342
|
-
- **"The greater good"**: Running gag with payoff
|
|
343
|
-
- **Final Shootout**: Action parody with comedic commitment
|
|
344
|
-
|
|
345
|
-
**Techniques Used**:
|
|
346
|
-
- Visual comedy and editing
|
|
347
|
-
- Setup and payoff
|
|
348
|
-
- Genre awareness
|
|
349
|
-
- Commitment to premise
|
|
350
|
-
|
|
351
|
-
---
|
|
352
|
-
|
|
353
|
-
## Integration with Other Features
|
|
354
|
-
|
|
355
|
-
### Compatible Themes
|
|
356
|
-
|
|
357
|
-
- **Growth**: Character learns through comedic mistakes (Groundhog Day)
|
|
358
|
-
- **Love**: Romantic comedy (When Harry Met Sally)
|
|
359
|
-
- **Identity**: Character discovers themselves through humor (Tootsie)
|
|
360
|
-
- **Friendship**: Bonds formed through shared absurdity (Superbad)
|
|
361
|
-
|
|
362
|
-
### Compatible Styles
|
|
363
|
-
|
|
364
|
-
- **Linear**: Traditional comedy structure (most comedies)
|
|
365
|
-
- **Ensemble**: Multiple comedic characters (The Hangover)
|
|
366
|
-
- **Satirical**: Social commentary through humor (Dr. Strangelove)
|
|
367
|
-
|
|
368
|
-
### Hybrid Combinations
|
|
369
|
-
|
|
370
|
-
- **Rom-Com**: Romance + Comedy (When Harry Met Sally, The Proposal)
|
|
371
|
-
- **Action-Comedy**: Action + Comedy (Rush Hour, The Nice Guys)
|
|
372
|
-
- **Horror-Comedy**: Horror + Comedy (Shaun of the Dead, What We Do in the Shadows)
|
|
373
|
-
- **Dramedy**: Drama + Comedy (Little Miss Sunshine, The Royal Tenenbaums)
|
|
374
|
-
|
|
375
|
-
## Best Practices
|
|
376
|
-
|
|
377
|
-
1. **Establish tone in first 5 pages** - Audience needs to know what kind of comedy to expect
|
|
378
|
-
2. **Make characters funny, not just situations** - Character-based comedy is sustainable
|
|
379
|
-
3. **Use the rule of three** - Setup, reinforcement, payoff/subversion
|
|
380
|
-
4. **Escalate the absurdity** - Each set piece should top the last
|
|
381
|
-
5. **Ground comedy in truth** - Exaggerate reality, don't abandon it
|
|
382
|
-
6. **Balance humor with heart** - Audiences need to care, not just laugh
|
|
383
|
-
7. **Vary your joke types** - Mix verbal, physical, situational, and character-based humor
|
|
384
|
-
8. **Trust the audience** - Don't explain jokes or telegraph punchlines
|
|
385
|
-
9. **Maintain internal logic** - Even absurd worlds need consistent rules
|
|
386
|
-
10. **Rewrite for rhythm** - Comedy is about timing; read dialogue aloud
|
|
387
|
-
|
|
388
|
-
## Resources
|
|
389
|
-
|
|
390
|
-
- "The Comic Toolbox" by John Vorhaus
|
|
391
|
-
- "Writing the Comedy Film" by Stuart Voytilla and Scott Petri
|
|
392
|
-
- "Poking a Dead Frog" by Mike Sacks
|
|
393
|
-
- "The Hidden Tools of Comedy" by Steve Kaplan
|
|
394
|
-
- Study: Groundhog Day, The Big Lebowski, Airplane!, Bridesmaids, Hot Fuzz, Arrested Development
|
|
395
|
-
|
|
396
|
-
---
|
|
397
|
-
|
|
398
|
-
**Depth Coverage**: 85%
|
|
399
|
-
**Last Updated**: 2026-01-31
|
|
400
|
-
**Version**: 1.0.0
|
|
401
|
-
|
|
1
|
+
# Comedy Genre
|
|
2
|
+
|
|
3
|
+
**Category**: Screenplay Genre
|
|
4
|
+
**Type**: Primary
|
|
5
|
+
**Complexity**: High
|
|
6
|
+
|
|
7
|
+
## Overview
|
|
8
|
+
|
|
9
|
+
Comedy films prioritize humor, laughter, and entertainment through wit, physical gags, situational irony, and character-based humor. The genre emphasizes timing, surprise, and the subversion of expectations.
|
|
10
|
+
|
|
11
|
+
## Core Concept
|
|
12
|
+
|
|
13
|
+
Comedy screenplays are built around creating laughter through character flaws, misunderstandings, absurd situations, or clever wordplay. Success depends on establishing a comedic tone early, maintaining consistent logic within the absurdity, and balancing humor with genuine emotion or stakes.
|
|
14
|
+
|
|
15
|
+
## Core Rules
|
|
16
|
+
|
|
17
|
+
### Rule 1: Establish the Comedic Tone Immediately
|
|
18
|
+
|
|
19
|
+
**Description**: The first 5-10 pages must signal to the audience what kind of comedy this is and what to expect.
|
|
20
|
+
|
|
21
|
+
**Why It Matters**: Audiences need to calibrate their expectations. Tonal confusion kills comedy.
|
|
22
|
+
|
|
23
|
+
**Examples**:
|
|
24
|
+
- ✅ **Good**: Opening scene demonstrates the specific type of humor (slapstick, witty banter, awkward situations)
|
|
25
|
+
- ❌ **Bad**: First 20 pages are serious drama, then comedy appears randomly
|
|
26
|
+
|
|
27
|
+
**Film Reference**: Airplane! (1980) - Absurdist humor established in the first minute.
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
### Rule 2: Comedy Comes from Character
|
|
32
|
+
|
|
33
|
+
**Description**: The funniest moments arise from characters behaving consistently with their established personalities, not from random jokes.
|
|
34
|
+
|
|
35
|
+
**Why It Matters**: Character-based comedy is sustainable and emotionally resonant. Random jokes feel disconnected.
|
|
36
|
+
|
|
37
|
+
**Examples**:
|
|
38
|
+
- ✅ **Good**: Uptight character's rigid behavior creates humor in chaotic situations
|
|
39
|
+
- ❌ **Bad**: Characters act out of character just to deliver a punchline
|
|
40
|
+
|
|
41
|
+
**Film Reference**: The Big Lebowski (1998) - The Dude's laid-back personality creates humor in every situation.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
### Rule 3: Rule of Three
|
|
46
|
+
|
|
47
|
+
**Description**: Comedic patterns work best in threes - setup, reinforcement, payoff/subversion.
|
|
48
|
+
|
|
49
|
+
**Why It Matters**: Two is predictable, four is repetitive. Three is the sweet spot for comedic rhythm.
|
|
50
|
+
|
|
51
|
+
**Examples**:
|
|
52
|
+
- ✅ **Good**: Character fails twice in similar ways, third attempt succeeds in unexpected manner
|
|
53
|
+
- ❌ **Bad**: Same joke repeated five times with no variation
|
|
54
|
+
|
|
55
|
+
**Film Reference**: Hot Fuzz (2007) - "The greater good" repeated three times for comedic effect.
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
### Rule 4: Escalate the Absurdity
|
|
60
|
+
|
|
61
|
+
**Description**: Each comedic set piece should be more outrageous than the last, while maintaining internal logic.
|
|
62
|
+
|
|
63
|
+
**Why It Matters**: Escalation maintains energy and prevents the comedy from feeling flat or repetitive.
|
|
64
|
+
|
|
65
|
+
**Examples**:
|
|
66
|
+
- ✅ **Good**: Small lie → bigger lie to cover first lie → elaborate scheme to maintain lies → complete chaos
|
|
67
|
+
- ❌ **Bad**: Same level of absurdity throughout with no escalation
|
|
68
|
+
|
|
69
|
+
**Film Reference**: Liar Liar (1997) - Jim Carrey's inability to lie escalates from minor to catastrophic.
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
### Rule 5: Subvert Expectations
|
|
74
|
+
|
|
75
|
+
**Description**: Set up audience expectations, then deliver something unexpected but logical in hindsight.
|
|
76
|
+
|
|
77
|
+
**Why It Matters**: Surprise is essential to comedy. Predictable jokes aren't funny.
|
|
78
|
+
|
|
79
|
+
**Examples**:
|
|
80
|
+
- ✅ **Good**: Setup suggests one outcome, deliver a different but equally logical outcome
|
|
81
|
+
- ❌ **Bad**: Telegraphed punchlines the audience sees coming
|
|
82
|
+
|
|
83
|
+
**Film Reference**: Monty Python and the Holy Grail (1975) - Constant subversion of medieval epic expectations.
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
### Rule 6: Ground Comedy in Truth
|
|
88
|
+
|
|
89
|
+
**Description**: Even absurd comedy should be rooted in recognizable human behavior, emotions, or situations.
|
|
90
|
+
|
|
91
|
+
**Why It Matters**: Audiences connect with truth. Grounded comedy is more relatable and sustainable.
|
|
92
|
+
|
|
93
|
+
**Examples**:
|
|
94
|
+
- ✅ **Good**: Exaggerated version of real awkward social situations
|
|
95
|
+
- ❌ **Bad**: Random absurdity with no connection to reality
|
|
96
|
+
|
|
97
|
+
**Film Reference**: The Office (2005-2013) - Workplace comedy grounded in real office dynamics.
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
### Rule 7: Timing is Everything
|
|
102
|
+
|
|
103
|
+
**Description**: Comedic beats need proper setup, breathing room, and precise delivery timing on the page.
|
|
104
|
+
|
|
105
|
+
**Why It Matters**: Rushed or poorly timed jokes fall flat. White space and pacing create rhythm.
|
|
106
|
+
|
|
107
|
+
**Examples**:
|
|
108
|
+
- ✅ **Good**: Setup... brief pause... punchline. New paragraph for reaction.
|
|
109
|
+
- ❌ **Bad**: Setup and punchline crammed together with no breathing room
|
|
110
|
+
|
|
111
|
+
**Film Reference**: Arrested Development (2003-2019) - Masterful comedic timing and callbacks.
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
### Rule 8: Create Comedic Conflict
|
|
116
|
+
|
|
117
|
+
**Description**: Comedy should arise from genuine conflict between characters, goals, or values.
|
|
118
|
+
|
|
119
|
+
**Why It Matters**: Conflict creates stakes and makes the comedy meaningful, not just random gags.
|
|
120
|
+
|
|
121
|
+
**Examples**:
|
|
122
|
+
- ✅ **Good**: Two characters with opposing goals forced to work together
|
|
123
|
+
- ❌ **Bad**: Characters tell jokes at each other with no real conflict
|
|
124
|
+
|
|
125
|
+
**Film Reference**: The Odd Couple (1968) - Conflict between neat freak and slob drives all comedy.
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
### Rule 9: Balance Humor with Heart
|
|
130
|
+
|
|
131
|
+
**Description**: Audiences need to care about characters and outcomes, not just laugh at them.
|
|
132
|
+
|
|
133
|
+
**Why It Matters**: Pure mockery becomes mean. Emotional investment makes comedy more satisfying.
|
|
134
|
+
|
|
135
|
+
**Examples**:
|
|
136
|
+
- ✅ **Good**: We laugh with characters we care about, not just at them
|
|
137
|
+
- ❌ **Bad**: Characters are punching bags with no depth or sympathy
|
|
138
|
+
|
|
139
|
+
**Film Reference**: Groundhog Day (1993) - Bill Murray's character growth gives comedy emotional weight.
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
### Rule 10: Maintain Internal Logic
|
|
144
|
+
|
|
145
|
+
**Description**: Even in absurd comedy, the world must follow its own established rules consistently.
|
|
146
|
+
|
|
147
|
+
**Why It Matters**: Inconsistent logic feels lazy. Consistent absurdity is funnier.
|
|
148
|
+
|
|
149
|
+
**Examples**:
|
|
150
|
+
- ✅ **Good**: If magic exists, it follows specific rules that create comedic situations
|
|
151
|
+
- ❌ **Bad**: Rules change based on what's convenient for the joke
|
|
152
|
+
|
|
153
|
+
**Film Reference**: Ghostbusters (1984) - Supernatural elements follow consistent rules that enable comedy.
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
## Guidelines
|
|
158
|
+
|
|
159
|
+
### Structure
|
|
160
|
+
|
|
161
|
+
- **Act I**: Establish comedic tone, introduce flawed protagonist, inciting incident creates comedic situation (pages 1-25)
|
|
162
|
+
- **Act II**: Escalating comedic complications, character's flaws make things worse, false victory, all seems lost (pages 25-85)
|
|
163
|
+
- **Act III**: Final comedic set piece, character growth resolves situation, emotional payoff (pages 85-110)
|
|
164
|
+
|
|
165
|
+
### Pacing
|
|
166
|
+
|
|
167
|
+
- Joke or comedic moment every page (at minimum)
|
|
168
|
+
- Major comedic set piece every 10-15 pages
|
|
169
|
+
- Vary joke types (verbal, physical, situational, character-based)
|
|
170
|
+
- Allow brief emotional beats between major comedic sequences
|
|
171
|
+
- Build to biggest laugh in climax
|
|
172
|
+
|
|
173
|
+
### Character Archetypes
|
|
174
|
+
|
|
175
|
+
- **Protagonist**: Flawed but likable, often oblivious to their own ridiculousness
|
|
176
|
+
- **Straight Man**: Reacts to absurdity, grounds the comedy
|
|
177
|
+
- **Comic Relief**: Intentionally funny character (use sparingly in comedy - everyone should be funny)
|
|
178
|
+
- **Antagonist**: Often uptight, rigid, or representing what protagonist must overcome
|
|
179
|
+
|
|
180
|
+
### Tone and Atmosphere
|
|
181
|
+
|
|
182
|
+
- Consistent comedic voice throughout
|
|
183
|
+
- Optimistic and playful
|
|
184
|
+
- Self-aware without being meta (unless that's the style)
|
|
185
|
+
- Energetic pacing
|
|
186
|
+
- Subgenre-specific (slapstick vs. witty vs. dark comedy)
|
|
187
|
+
|
|
188
|
+
### Visual Style
|
|
189
|
+
|
|
190
|
+
- Physical comedy requires clear staging
|
|
191
|
+
- Reaction shots are crucial
|
|
192
|
+
- Visual gags in background
|
|
193
|
+
- Exaggerated but readable expressions
|
|
194
|
+
- Timing indicated through white space and formatting
|
|
195
|
+
|
|
196
|
+
### Dialogue
|
|
197
|
+
|
|
198
|
+
- Wit and wordplay
|
|
199
|
+
- Subtext and irony
|
|
200
|
+
- Callbacks and running gags
|
|
201
|
+
- Rhythm and musicality
|
|
202
|
+
- Character-specific speech patterns that create humor
|
|
203
|
+
|
|
204
|
+
## Common Pitfalls
|
|
205
|
+
|
|
206
|
+
### Pitfall 1: Jokes Without Story
|
|
207
|
+
|
|
208
|
+
**Problem**: String of unconnected gags with no narrative throughline.
|
|
209
|
+
|
|
210
|
+
**Solution**: Every joke should serve character or plot. Comedy enhances story, doesn't replace it.
|
|
211
|
+
|
|
212
|
+
**Example**: Jokes arise from character trying to achieve their goal, not random asides.
|
|
213
|
+
|
|
214
|
+
---
|
|
215
|
+
|
|
216
|
+
### Pitfall 2: Mean-Spirited Humor
|
|
217
|
+
|
|
218
|
+
**Problem**: Laughing at characters' pain without empathy or growth.
|
|
219
|
+
|
|
220
|
+
**Solution**: Make characters sympathetic. Earn the right to mock them by making them human first.
|
|
221
|
+
|
|
222
|
+
**Example**: We laugh at their mistakes because we relate, not because we're cruel.
|
|
223
|
+
|
|
224
|
+
---
|
|
225
|
+
|
|
226
|
+
### Pitfall 3: Explaining the Joke
|
|
227
|
+
|
|
228
|
+
**Problem**: Characters or narration explain why something is funny.
|
|
229
|
+
|
|
230
|
+
**Solution**: Trust the audience. If a joke needs explanation, it's not working.
|
|
231
|
+
|
|
232
|
+
**Example**: Let the situation speak for itself. Cut any line that says "That's funny because..."
|
|
233
|
+
|
|
234
|
+
---
|
|
235
|
+
|
|
236
|
+
### Pitfall 4: Inconsistent Tone
|
|
237
|
+
|
|
238
|
+
**Problem**: Shifting between comedy styles or mixing comedy with drama clumsily.
|
|
239
|
+
|
|
240
|
+
**Solution**: Establish your comedic voice early and maintain it. Emotional moments should feel earned, not jarring.
|
|
241
|
+
|
|
242
|
+
**Example**: Dramedy requires careful balance - don't undercut serious moments with inappropriate jokes.
|
|
243
|
+
|
|
244
|
+
---
|
|
245
|
+
|
|
246
|
+
### Pitfall 5: Relying on References
|
|
247
|
+
|
|
248
|
+
**Problem**: Jokes depend entirely on pop culture references that will date quickly.
|
|
249
|
+
|
|
250
|
+
**Solution**: Use references sparingly. Focus on character and situation-based humor that's timeless.
|
|
251
|
+
|
|
252
|
+
**Example**: Character-based humor from Groundhog Day still works decades later; topical references from 1993 don't.
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
## Film Examples
|
|
257
|
+
|
|
258
|
+
### Example 1: Groundhog Day (1993)
|
|
259
|
+
|
|
260
|
+
**Director**: Harold Ramis
|
|
261
|
+
|
|
262
|
+
**Why It Works**: High-concept premise, character growth, perfect balance of humor and heart.
|
|
263
|
+
|
|
264
|
+
**Key Scenes**:
|
|
265
|
+
- **First Loop**: Establishes the comedic premise
|
|
266
|
+
- **Montage of Attempts**: Escalating absurdity as Phil tries different approaches
|
|
267
|
+
- **Piano Lesson**: Emotional depth beneath the comedy
|
|
268
|
+
|
|
269
|
+
**Techniques Used**:
|
|
270
|
+
- Repetition with variation
|
|
271
|
+
- Character transformation through comedy
|
|
272
|
+
- Grounded fantasy premise
|
|
273
|
+
- Emotional payoff
|
|
274
|
+
|
|
275
|
+
---
|
|
276
|
+
|
|
277
|
+
### Example 2: The Big Lebowski (1998)
|
|
278
|
+
|
|
279
|
+
**Director**: Joel and Ethan Coen
|
|
280
|
+
|
|
281
|
+
**Why It Works**: Unique characters, quotable dialogue, absurd situations grounded in character.
|
|
282
|
+
|
|
283
|
+
**Key Scenes**:
|
|
284
|
+
- **Rug Peed On**: Inciting incident is perfectly absurd
|
|
285
|
+
- **Bowling Alley**: Character dynamics create constant humor
|
|
286
|
+
- **Dream Sequence**: Surreal comedy that fits the tone
|
|
287
|
+
|
|
288
|
+
**Techniques Used**:
|
|
289
|
+
- Character-based humor
|
|
290
|
+
- Quotable dialogue
|
|
291
|
+
- Absurdist situations
|
|
292
|
+
- Consistent tone
|
|
293
|
+
|
|
294
|
+
---
|
|
295
|
+
|
|
296
|
+
### Example 3: Airplane! (1980)
|
|
297
|
+
|
|
298
|
+
**Director**: Jim Abrahams, David Zucker, Jerry Zucker
|
|
299
|
+
|
|
300
|
+
**Why It Works**: Rapid-fire jokes, visual gags, parody done right, commitment to absurdity.
|
|
301
|
+
|
|
302
|
+
**Key Scenes**:
|
|
303
|
+
- **"Don't call me Shirley"**: Wordplay and deadpan delivery
|
|
304
|
+
- **Autopilot**: Visual gag taken to extreme
|
|
305
|
+
- **"I picked the wrong week to quit smoking"**: Running gag escalation
|
|
306
|
+
|
|
307
|
+
**Techniques Used**:
|
|
308
|
+
- Joke density (multiple jokes per page)
|
|
309
|
+
- Deadpan delivery of absurdity
|
|
310
|
+
- Visual and verbal gags layered
|
|
311
|
+
- Parody with love for source material
|
|
312
|
+
|
|
313
|
+
---
|
|
314
|
+
|
|
315
|
+
### Example 4: Bridesmaids (2011)
|
|
316
|
+
|
|
317
|
+
**Director**: Paul Feig
|
|
318
|
+
|
|
319
|
+
**Why It Works**: Female-driven comedy, emotional authenticity, mix of crude and heartfelt humor.
|
|
320
|
+
|
|
321
|
+
**Key Scenes**:
|
|
322
|
+
- **Bridal Shop Food Poisoning**: Physical comedy with character stakes
|
|
323
|
+
- **Airplane Freakout**: Escalating absurdity from character flaw
|
|
324
|
+
- **Reconciliation**: Emotional payoff earned through comedy
|
|
325
|
+
|
|
326
|
+
**Techniques Used**:
|
|
327
|
+
- Character flaws drive comedy
|
|
328
|
+
- Balance crude and sweet
|
|
329
|
+
- Female friendship as foundation
|
|
330
|
+
- Emotional stakes
|
|
331
|
+
|
|
332
|
+
---
|
|
333
|
+
|
|
334
|
+
### Example 5: Hot Fuzz (2007)
|
|
335
|
+
|
|
336
|
+
**Director**: Edgar Wright
|
|
337
|
+
|
|
338
|
+
**Why It Works**: Genre parody, visual comedy, tight plotting, callbacks and payoffs.
|
|
339
|
+
|
|
340
|
+
**Key Scenes**:
|
|
341
|
+
- **Paperwork Montage**: Action movie editing for mundane tasks
|
|
342
|
+
- **"The greater good"**: Running gag with payoff
|
|
343
|
+
- **Final Shootout**: Action parody with comedic commitment
|
|
344
|
+
|
|
345
|
+
**Techniques Used**:
|
|
346
|
+
- Visual comedy and editing
|
|
347
|
+
- Setup and payoff
|
|
348
|
+
- Genre awareness
|
|
349
|
+
- Commitment to premise
|
|
350
|
+
|
|
351
|
+
---
|
|
352
|
+
|
|
353
|
+
## Integration with Other Features
|
|
354
|
+
|
|
355
|
+
### Compatible Themes
|
|
356
|
+
|
|
357
|
+
- **Growth**: Character learns through comedic mistakes (Groundhog Day)
|
|
358
|
+
- **Love**: Romantic comedy (When Harry Met Sally)
|
|
359
|
+
- **Identity**: Character discovers themselves through humor (Tootsie)
|
|
360
|
+
- **Friendship**: Bonds formed through shared absurdity (Superbad)
|
|
361
|
+
|
|
362
|
+
### Compatible Styles
|
|
363
|
+
|
|
364
|
+
- **Linear**: Traditional comedy structure (most comedies)
|
|
365
|
+
- **Ensemble**: Multiple comedic characters (The Hangover)
|
|
366
|
+
- **Satirical**: Social commentary through humor (Dr. Strangelove)
|
|
367
|
+
|
|
368
|
+
### Hybrid Combinations
|
|
369
|
+
|
|
370
|
+
- **Rom-Com**: Romance + Comedy (When Harry Met Sally, The Proposal)
|
|
371
|
+
- **Action-Comedy**: Action + Comedy (Rush Hour, The Nice Guys)
|
|
372
|
+
- **Horror-Comedy**: Horror + Comedy (Shaun of the Dead, What We Do in the Shadows)
|
|
373
|
+
- **Dramedy**: Drama + Comedy (Little Miss Sunshine, The Royal Tenenbaums)
|
|
374
|
+
|
|
375
|
+
## Best Practices
|
|
376
|
+
|
|
377
|
+
1. **Establish tone in first 5 pages** - Audience needs to know what kind of comedy to expect
|
|
378
|
+
2. **Make characters funny, not just situations** - Character-based comedy is sustainable
|
|
379
|
+
3. **Use the rule of three** - Setup, reinforcement, payoff/subversion
|
|
380
|
+
4. **Escalate the absurdity** - Each set piece should top the last
|
|
381
|
+
5. **Ground comedy in truth** - Exaggerate reality, don't abandon it
|
|
382
|
+
6. **Balance humor with heart** - Audiences need to care, not just laugh
|
|
383
|
+
7. **Vary your joke types** - Mix verbal, physical, situational, and character-based humor
|
|
384
|
+
8. **Trust the audience** - Don't explain jokes or telegraph punchlines
|
|
385
|
+
9. **Maintain internal logic** - Even absurd worlds need consistent rules
|
|
386
|
+
10. **Rewrite for rhythm** - Comedy is about timing; read dialogue aloud
|
|
387
|
+
|
|
388
|
+
## Resources
|
|
389
|
+
|
|
390
|
+
- "The Comic Toolbox" by John Vorhaus
|
|
391
|
+
- "Writing the Comedy Film" by Stuart Voytilla and Scott Petri
|
|
392
|
+
- "Poking a Dead Frog" by Mike Sacks
|
|
393
|
+
- "The Hidden Tools of Comedy" by Steve Kaplan
|
|
394
|
+
- Study: Groundhog Day, The Big Lebowski, Airplane!, Bridesmaids, Hot Fuzz, Arrested Development
|
|
395
|
+
|
|
396
|
+
---
|
|
397
|
+
|
|
398
|
+
**Depth Coverage**: 85%
|
|
399
|
+
**Last Updated**: 2026-01-31
|
|
400
|
+
**Version**: 1.0.0
|
|
401
|
+
|