@mytechtoday/augment-extensions 0.5.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 +113 -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 +15 -0
- package/cli/dist/commands/show.d.ts.map +1 -1
- package/cli/dist/commands/show.js +576 -23
- 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/config-system.d.ts +111 -0
- package/cli/dist/utils/config-system.d.ts.map +1 -0
- package/cli/dist/utils/config-system.js +239 -0
- package/cli/dist/utils/config-system.js.map +1 -0
- 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/hook-system.d.ts +84 -0
- package/cli/dist/utils/hook-system.d.ts.map +1 -0
- package/cli/dist/utils/hook-system.js +151 -0
- package/cli/dist/utils/hook-system.js.map +1 -0
- package/cli/dist/utils/inspection-cache.d.ts +56 -0
- package/cli/dist/utils/inspection-cache.d.ts.map +1 -0
- package/cli/dist/utils/inspection-cache.js +166 -0
- package/cli/dist/utils/inspection-cache.js.map +1 -0
- package/cli/dist/utils/inspection-handlers.d.ts +75 -0
- package/cli/dist/utils/inspection-handlers.d.ts.map +1 -0
- package/cli/dist/utils/inspection-handlers.js +171 -0
- package/cli/dist/utils/inspection-handlers.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/module-system.d.ts +1 -0
- package/cli/dist/utils/module-system.d.ts.map +1 -1
- package/cli/dist/utils/module-system.js +8 -3
- package/cli/dist/utils/module-system.js.map +1 -1
- package/cli/dist/utils/plugin-system.d.ts +133 -0
- package/cli/dist/utils/plugin-system.d.ts.map +1 -0
- package/cli/dist/utils/plugin-system.js +210 -0
- package/cli/dist/utils/plugin-system.js.map +1 -0
- package/cli/dist/utils/progress.d.ts +67 -0
- package/cli/dist/utils/progress.d.ts.map +1 -0
- package/cli/dist/utils/progress.js +146 -0
- package/cli/dist/utils/progress.js.map +1 -0
- package/cli/dist/utils/rule-install-hooks.js +8 -8
- package/cli/dist/utils/stream-reader.d.ts +34 -0
- package/cli/dist/utils/stream-reader.d.ts.map +1 -0
- package/cli/dist/utils/stream-reader.js +147 -0
- package/cli/dist/utils/stream-reader.js.map +1 -0
- package/cli/dist/utils/vscode-editor.d.ts +45 -0
- package/cli/dist/utils/vscode-editor.d.ts.map +1 -0
- package/cli/dist/utils/vscode-editor.js +171 -0
- package/cli/dist/utils/vscode-editor.js.map +1 -0
- package/cli/dist/utils/vscode-links.d.ts +49 -0
- package/cli/dist/utils/vscode-links.d.ts.map +1 -0
- package/cli/dist/utils/vscode-links.js +167 -0
- package/cli/dist/utils/vscode-links.js.map +1 -0
- package/modules.md +667 -630
- package/package.json +85 -85
|
@@ -1,407 +1,407 @@
|
|
|
1
|
-
# Adventure Genre
|
|
2
|
-
|
|
3
|
-
**Category**: Screenplay Genre
|
|
4
|
-
**Type**: Primary
|
|
5
|
-
**Complexity**: Medium
|
|
6
|
-
|
|
7
|
-
## Overview
|
|
8
|
-
|
|
9
|
-
Adventure films follow protagonists on journeys of discovery, featuring exotic locations, treasure hunts, quests, and exploration. The genre emphasizes wonder, discovery, and the thrill of the unknown.
|
|
10
|
-
|
|
11
|
-
## Core Concept
|
|
12
|
-
|
|
13
|
-
Adventure screenplays are built around a journey - physical, emotional, or both. The protagonist leaves their ordinary world to pursue a goal in an extraordinary setting, facing obstacles that test their courage, resourcefulness, and character. Success depends on balancing spectacle with personal growth and maintaining a sense of wonder throughout.
|
|
14
|
-
|
|
15
|
-
## Core Rules
|
|
16
|
-
|
|
17
|
-
### Rule 1: Establish a Clear Quest or Goal
|
|
18
|
-
|
|
19
|
-
**Description**: The protagonist must have a specific, tangible objective that drives the journey forward.
|
|
20
|
-
|
|
21
|
-
**Why It Matters**: Without a clear goal, the adventure becomes aimless wandering. The quest provides structure and purpose.
|
|
22
|
-
|
|
23
|
-
**Examples**:
|
|
24
|
-
- ✅ **Good**: "Find the lost city of gold before the rival expedition"
|
|
25
|
-
- ❌ **Bad**: "Travel around and see what happens"
|
|
26
|
-
|
|
27
|
-
**Film Reference**: Raiders of the Lost Ark (1981) - Indiana Jones must find the Ark of the Covenant before the Nazis.
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
### Rule 2: Create a Journey Structure
|
|
32
|
-
|
|
33
|
-
**Description**: The story should follow a clear geographical and emotional journey with distinct stages and locations.
|
|
34
|
-
|
|
35
|
-
**Why It Matters**: The journey structure provides natural act breaks and escalation. Each new location brings new challenges.
|
|
36
|
-
|
|
37
|
-
**Examples**:
|
|
38
|
-
- ✅ **Good**: Home → First obstacle → Exotic location → Greater challenge → Final destination
|
|
39
|
-
- ❌ **Bad**: All action happens in one location with no sense of progression
|
|
40
|
-
|
|
41
|
-
**Film Reference**: The Lord of the Rings (2001-2003) - Clear journey from Shire to Mordor with distinct stages.
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
### Rule 3: Emphasize Discovery and Wonder
|
|
46
|
-
|
|
47
|
-
**Description**: Reveal new worlds, creatures, cultures, or knowledge that amazes both protagonist and audience.
|
|
48
|
-
|
|
49
|
-
**Why It Matters**: Wonder is the emotional core of adventure. Discovery creates excitement and justifies the journey.
|
|
50
|
-
|
|
51
|
-
**Examples**:
|
|
52
|
-
- ✅ **Good**: "They enter the hidden temple, revealing ancient murals and impossible architecture"
|
|
53
|
-
- ❌ **Bad**: "They find a room with some old stuff"
|
|
54
|
-
|
|
55
|
-
**Film Reference**: Jurassic Park (1993) - The first dinosaur reveal creates pure wonder.
|
|
56
|
-
|
|
57
|
-
---
|
|
58
|
-
|
|
59
|
-
### Rule 4: Include Diverse Obstacles
|
|
60
|
-
|
|
61
|
-
**Description**: Mix physical challenges, environmental hazards, antagonists, and moral dilemmas throughout the journey.
|
|
62
|
-
|
|
63
|
-
**Why It Matters**: Varied obstacles keep the adventure fresh and test different aspects of the protagonist's character.
|
|
64
|
-
|
|
65
|
-
**Examples**:
|
|
66
|
-
- ✅ **Good**: Treacherous terrain → hostile natives → rival treasure hunters → moral choice about the treasure
|
|
67
|
-
- ❌ **Bad**: The same type of obstacle repeated throughout
|
|
68
|
-
|
|
69
|
-
**Film Reference**: The Mummy (1999) - Combines traps, mummies, rival treasure hunters, and supernatural threats.
|
|
70
|
-
|
|
71
|
-
---
|
|
72
|
-
|
|
73
|
-
### Rule 5: Transform the Hero Through the Journey
|
|
74
|
-
|
|
75
|
-
**Description**: The adventure should fundamentally change the protagonist, teaching them something essential about themselves or the world.
|
|
76
|
-
|
|
77
|
-
**Why It Matters**: Physical journey without emotional growth is hollow. The external adventure should mirror internal transformation.
|
|
78
|
-
|
|
79
|
-
**Examples**:
|
|
80
|
-
- ✅ **Good**: Selfish treasure hunter learns the value of friendship and sacrifice
|
|
81
|
-
- ❌ **Bad**: Hero returns home exactly as they left, having learned nothing
|
|
82
|
-
|
|
83
|
-
**Film Reference**: The Wizard of Oz (1939) - Dorothy learns "there's no place like home" through her journey.
|
|
84
|
-
|
|
85
|
-
---
|
|
86
|
-
|
|
87
|
-
### Rule 6: Establish High Stakes Beyond Personal Gain
|
|
88
|
-
|
|
89
|
-
**Description**: While personal goals drive the hero, larger stakes should emerge - saving others, preventing catastrophe, or protecting something valuable.
|
|
90
|
-
|
|
91
|
-
**Why It Matters**: Pure self-interest limits audience investment. Higher stakes create urgency and moral weight.
|
|
92
|
-
|
|
93
|
-
**Examples**:
|
|
94
|
-
- ✅ **Good**: Finding the artifact will save the village from destruction
|
|
95
|
-
- ❌ **Bad**: Finding the artifact will make the hero rich (and nothing else matters)
|
|
96
|
-
|
|
97
|
-
**Film Reference**: Indiana Jones and the Last Crusade (1989) - Starts as personal (save father), escalates to global (prevent Nazi immortality).
|
|
98
|
-
|
|
99
|
-
---
|
|
100
|
-
|
|
101
|
-
### Rule 7: Create a Worthy Antagonist or Obstacle
|
|
102
|
-
|
|
103
|
-
**Description**: The opposition should be formidable, whether a villain, rival, nature, or the quest itself.
|
|
104
|
-
|
|
105
|
-
**Why It Matters**: Easy victories diminish the adventure. Worthy opposition makes success meaningful.
|
|
106
|
-
|
|
107
|
-
**Examples**:
|
|
108
|
-
- ✅ **Good**: Rival expedition with more resources, or treacherous mountain that has defeated all previous climbers
|
|
109
|
-
- ❌ **Bad**: Easily defeated obstacles that pose no real threat
|
|
110
|
-
|
|
111
|
-
**Film Reference**: The Princess Bride (1987) - Each obstacle (Fezzik, Inigo, Vizzini, Fire Swamp) is uniquely challenging.
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
115
|
-
### Rule 8: Use Exotic or Extraordinary Settings
|
|
116
|
-
|
|
117
|
-
**Description**: Take the audience to places they've never been - geographically, historically, or fantastically.
|
|
118
|
-
|
|
119
|
-
**Why It Matters**: Setting is character in adventure films. Extraordinary locations create visual interest and unique challenges.
|
|
120
|
-
|
|
121
|
-
**Examples**:
|
|
122
|
-
- ✅ **Good**: Ancient ruins in the Amazon, underwater city, alien planet, medieval kingdom
|
|
123
|
-
- ❌ **Bad**: Generic modern city with no distinctive features
|
|
124
|
-
|
|
125
|
-
**Film Reference**: Avatar (2009) - Pandora is a fully realized alien world that drives the adventure.
|
|
126
|
-
|
|
127
|
-
---
|
|
128
|
-
|
|
129
|
-
### Rule 9: Include Moments of Camaraderie
|
|
130
|
-
|
|
131
|
-
**Description**: Show the bonds formed between adventurers through shared danger and triumph.
|
|
132
|
-
|
|
133
|
-
**Why It Matters**: Relationships humanize the adventure and provide emotional stakes beyond the quest itself.
|
|
134
|
-
|
|
135
|
-
**Examples**:
|
|
136
|
-
- ✅ **Good**: Quiet campfire scene where characters share stories and bond
|
|
137
|
-
- ❌ **Bad**: Characters remain strangers despite traveling together for weeks
|
|
138
|
-
|
|
139
|
-
**Film Reference**: The Goonies (1985) - Friendship is as important as the treasure hunt.
|
|
140
|
-
|
|
141
|
-
---
|
|
142
|
-
|
|
143
|
-
### Rule 10: Balance Realism and Fantasy
|
|
144
|
-
|
|
145
|
-
**Description**: Even in fantastical settings, maintain internal logic and consequences. Ground the extraordinary in relatable emotions.
|
|
146
|
-
|
|
147
|
-
**Why It Matters**: Complete fantasy without grounding loses audience connection. Believable reactions to unbelievable situations create engagement.
|
|
148
|
-
|
|
149
|
-
**Examples**:
|
|
150
|
-
- ✅ **Good**: Characters react with appropriate awe, fear, or skepticism to fantastic elements
|
|
151
|
-
- ❌ **Bad**: Characters accept impossible things without reaction
|
|
152
|
-
|
|
153
|
-
**Film Reference**: Pirates of the Caribbean (2003) - Supernatural elements grounded by character reactions and consequences.
|
|
154
|
-
|
|
155
|
-
---
|
|
156
|
-
|
|
157
|
-
## Guidelines
|
|
158
|
-
|
|
159
|
-
### Structure
|
|
160
|
-
|
|
161
|
-
- **Act I**: Ordinary world, call to adventure, refusal, crossing threshold (pages 1-25)
|
|
162
|
-
- **Act II**: Tests and trials, allies and enemies, approach to innermost cave, ordeal (pages 25-85)
|
|
163
|
-
- **Act III**: Reward, road back, resurrection, return with elixir (pages 85-110)
|
|
164
|
-
|
|
165
|
-
### Pacing
|
|
166
|
-
|
|
167
|
-
- Establish ordinary world quickly (5-10 pages)
|
|
168
|
-
- Cross into adventure by page 15-20
|
|
169
|
-
- New location or major discovery every 15-20 pages
|
|
170
|
-
- Build to climactic final challenge
|
|
171
|
-
- Allow brief moments of rest between major obstacles
|
|
172
|
-
|
|
173
|
-
### Character Archetypes
|
|
174
|
-
|
|
175
|
-
- **Protagonist**: Curious, brave, resourceful, often reluctant at first, grows through journey
|
|
176
|
-
- **Mentor**: Wise guide who prepares hero (often dies or departs before final challenge)
|
|
177
|
-
- **Allies**: Diverse companions with complementary skills
|
|
178
|
-
- **Antagonist**: Rival adventurer, tyrant, or force of nature opposing the quest
|
|
179
|
-
- **Threshold Guardian**: Tests hero's worthiness to continue
|
|
180
|
-
|
|
181
|
-
### Tone and Atmosphere
|
|
182
|
-
|
|
183
|
-
- Sense of wonder and possibility
|
|
184
|
-
- Optimistic despite danger
|
|
185
|
-
- Humor balances peril
|
|
186
|
-
- Exotic and immersive
|
|
187
|
-
- Emphasis on discovery over destruction
|
|
188
|
-
|
|
189
|
-
### Visual Style
|
|
190
|
-
|
|
191
|
-
- Sweeping vistas and establishing shots of exotic locations
|
|
192
|
-
- Vibrant color palette
|
|
193
|
-
- Practical locations when possible for authenticity
|
|
194
|
-
- Emphasis on scale and grandeur
|
|
195
|
-
- Visual contrast between ordinary and extraordinary worlds
|
|
196
|
-
|
|
197
|
-
### Dialogue
|
|
198
|
-
|
|
199
|
-
- Exposition through discovery, not explanation
|
|
200
|
-
- Banter and camaraderie between companions
|
|
201
|
-
- Expressions of wonder and awe
|
|
202
|
-
- Cultural or historical flavor appropriate to setting
|
|
203
|
-
- Minimal technical jargon unless it serves character
|
|
204
|
-
|
|
205
|
-
## Common Pitfalls
|
|
206
|
-
|
|
207
|
-
### Pitfall 1: Passive Protagonist
|
|
208
|
-
|
|
209
|
-
**Problem**: Hero is dragged along by events rather than driving the adventure forward.
|
|
210
|
-
|
|
211
|
-
**Solution**: Hero should make active choices that propel the journey. Give them agency and initiative.
|
|
212
|
-
|
|
213
|
-
**Example**: Hero chooses to pursue the quest despite warnings, not because they have no choice.
|
|
214
|
-
|
|
215
|
-
---
|
|
216
|
-
|
|
217
|
-
### Pitfall 2: Travelogue Without Stakes
|
|
218
|
-
|
|
219
|
-
**Problem**: Beautiful locations but no real danger or consequences.
|
|
220
|
-
|
|
221
|
-
**Solution**: Every location should present genuine obstacles. Beauty can coexist with peril.
|
|
222
|
-
|
|
223
|
-
**Example**: The paradise island also has deadly predators and hostile inhabitants.
|
|
224
|
-
|
|
225
|
-
---
|
|
226
|
-
|
|
227
|
-
### Pitfall 3: Convenient Solutions
|
|
228
|
-
|
|
229
|
-
**Problem**: Hero finds exactly what they need exactly when they need it.
|
|
230
|
-
|
|
231
|
-
**Solution**: Make the hero work for solutions. Foreshadow tools and knowledge earlier.
|
|
232
|
-
|
|
233
|
-
**Example**: The rope that saves them in Act III was acquired and mentioned in Act I.
|
|
234
|
-
|
|
235
|
-
---
|
|
236
|
-
|
|
237
|
-
### Pitfall 4: Forgettable Companions
|
|
238
|
-
|
|
239
|
-
**Problem**: Supporting characters are interchangeable and serve no distinct purpose.
|
|
240
|
-
|
|
241
|
-
**Solution**: Give each companion a unique skill, personality, and character arc.
|
|
242
|
-
|
|
243
|
-
**Example**: One is the navigator, one is the fighter, one is the scholar - each essential at different points.
|
|
244
|
-
|
|
245
|
-
---
|
|
246
|
-
|
|
247
|
-
### Pitfall 5: Anticlimactic Discovery
|
|
248
|
-
|
|
249
|
-
**Problem**: The goal of the quest is disappointing or underwhelming when finally reached.
|
|
250
|
-
|
|
251
|
-
**Solution**: Make the discovery worth the journey. Exceed expectations or subvert them meaningfully.
|
|
252
|
-
|
|
253
|
-
**Example**: The treasure is more wondrous than imagined, or the real treasure was the journey itself (if earned).
|
|
254
|
-
|
|
255
|
-
---
|
|
256
|
-
|
|
257
|
-
## Film Examples
|
|
258
|
-
|
|
259
|
-
### Example 1: Raiders of the Lost Ark (1981)
|
|
260
|
-
|
|
261
|
-
**Director**: Steven Spielberg
|
|
262
|
-
|
|
263
|
-
**Why It Works**: Perfect adventure structure, charismatic hero, exotic locations, constant forward momentum.
|
|
264
|
-
|
|
265
|
-
**Key Scenes**:
|
|
266
|
-
- **Opening Temple Sequence**: Establishes Indy's skills, love of archaeology, and sense of adventure
|
|
267
|
-
- **Truck Chase**: Escalating action in exotic location with clear stakes
|
|
268
|
-
- **Ark Opening**: Payoff of the quest with spectacular and dangerous results
|
|
269
|
-
|
|
270
|
-
**Techniques Used**:
|
|
271
|
-
- Hero's Journey structure
|
|
272
|
-
- Cliffhanger pacing
|
|
273
|
-
- Practical stunts and locations
|
|
274
|
-
- Balance of humor and danger
|
|
275
|
-
- Clear visual storytelling
|
|
276
|
-
|
|
277
|
-
---
|
|
278
|
-
|
|
279
|
-
### Example 2: The Lord of the Rings: The Fellowship of the Ring (2001)
|
|
280
|
-
|
|
281
|
-
**Director**: Peter Jackson
|
|
282
|
-
|
|
283
|
-
**Why It Works**: Epic scope, diverse companions, clear quest, rich world-building, emotional depth.
|
|
284
|
-
|
|
285
|
-
**Key Scenes**:
|
|
286
|
-
- **Shire to Rivendell**: Journey from ordinary to extraordinary world
|
|
287
|
-
- **Mines of Moria**: Peril, loss (Gandalf), and consequence
|
|
288
|
-
- **Breaking of the Fellowship**: Emotional climax as journey fractures
|
|
289
|
-
|
|
290
|
-
**Techniques Used**:
|
|
291
|
-
- Detailed world-building
|
|
292
|
-
- Distinct locations with unique challenges
|
|
293
|
-
- Character growth through adversity
|
|
294
|
-
- Balance of spectacle and intimacy
|
|
295
|
-
- Mythic storytelling
|
|
296
|
-
|
|
297
|
-
---
|
|
298
|
-
|
|
299
|
-
### Example 3: The Princess Bride (1987)
|
|
300
|
-
|
|
301
|
-
**Director**: Rob Reiner
|
|
302
|
-
|
|
303
|
-
**Why It Works**: Perfect blend of adventure, romance, and humor. Quotable dialogue, memorable characters.
|
|
304
|
-
|
|
305
|
-
**Key Scenes**:
|
|
306
|
-
- **Battle of Wits**: Intellectual challenge as adventure obstacle
|
|
307
|
-
- **Fire Swamp**: Environmental hazards test the couple
|
|
308
|
-
- **Storming the Castle**: Climactic rescue with teamwork
|
|
309
|
-
|
|
310
|
-
**Techniques Used**:
|
|
311
|
-
- Fairy tale structure
|
|
312
|
-
- Distinct obstacles requiring different skills
|
|
313
|
-
- Romance integrated into adventure
|
|
314
|
-
- Self-aware humor
|
|
315
|
-
- Satisfying payoffs
|
|
316
|
-
|
|
317
|
-
---
|
|
318
|
-
|
|
319
|
-
### Example 4: Jurassic Park (1993)
|
|
320
|
-
|
|
321
|
-
**Director**: Steven Spielberg
|
|
322
|
-
|
|
323
|
-
**Why It Works**: Wonder and terror balanced perfectly. Science fiction adventure with clear stakes.
|
|
324
|
-
|
|
325
|
-
**Key Scenes**:
|
|
326
|
-
- **First Dinosaur Reveal**: Pure wonder and awe
|
|
327
|
-
- **T-Rex Attack**: Terror in paradise
|
|
328
|
-
- **Raptor Kitchen**: Suspenseful climax
|
|
329
|
-
|
|
330
|
-
**Techniques Used**:
|
|
331
|
-
- Build wonder before introducing danger
|
|
332
|
-
- Science grounds the fantastic
|
|
333
|
-
- Children in peril raise stakes
|
|
334
|
-
- Practical effects create reality
|
|
335
|
-
- Clear cause and effect
|
|
336
|
-
|
|
337
|
-
---
|
|
338
|
-
|
|
339
|
-
### Example 5: The Goonies (1985)
|
|
340
|
-
|
|
341
|
-
**Director**: Richard Donner
|
|
342
|
-
|
|
343
|
-
**Why It Works**: Kid-friendly adventure with real stakes, treasure hunt structure, strong friendships.
|
|
344
|
-
|
|
345
|
-
**Key Scenes**:
|
|
346
|
-
- **Attic Discovery**: Call to adventure through found map
|
|
347
|
-
- **Underground Traps**: Escalating obstacles in exotic setting
|
|
348
|
-
- **Pirate Ship**: Reward and wonder
|
|
349
|
-
|
|
350
|
-
**Techniques Used**:
|
|
351
|
-
- Ensemble cast with distinct personalities
|
|
352
|
-
- Treasure hunt provides clear structure
|
|
353
|
-
- Humor and heart balance danger
|
|
354
|
-
- Coming-of-age through adventure
|
|
355
|
-
- Friendship as important as treasure
|
|
356
|
-
|
|
357
|
-
---
|
|
358
|
-
|
|
359
|
-
## Integration with Other Features
|
|
360
|
-
|
|
361
|
-
### Compatible Themes
|
|
362
|
-
|
|
363
|
-
- **Growth**: Hero matures through journey (The Goonies)
|
|
364
|
-
- **Friendship**: Bonds formed through shared adventure (Lord of the Rings)
|
|
365
|
-
- **Identity**: Hero discovers who they truly are (The Wizard of Oz)
|
|
366
|
-
- **Survival**: Physical journey tests limits (The Revenant)
|
|
367
|
-
|
|
368
|
-
### Compatible Styles
|
|
369
|
-
|
|
370
|
-
- **Epic**: Large-scale adventure across vast landscapes (Lord of the Rings)
|
|
371
|
-
- **Linear**: Clear journey from point A to point B (Raiders of the Lost Ark)
|
|
372
|
-
- **Ensemble**: Group of adventurers with shared goal (The Goonies)
|
|
373
|
-
|
|
374
|
-
### Hybrid Combinations
|
|
375
|
-
|
|
376
|
-
- **Action-Adventure**: Heavy emphasis on physical conflict (Indiana Jones series)
|
|
377
|
-
- **Fantasy-Adventure**: Magical elements and mythical quests (The NeverEnding Story)
|
|
378
|
-
- **Sci-Fi Adventure**: Space exploration and alien worlds (Star Wars, Avatar)
|
|
379
|
-
- **Comedy-Adventure**: Humor-driven adventure (The Princess Bride, Romancing the Stone)
|
|
380
|
-
|
|
381
|
-
## Best Practices
|
|
382
|
-
|
|
383
|
-
1. **Start with a compelling call to adventure** - Make the quest irresistible
|
|
384
|
-
2. **Create a vivid, immersive world** - Transport the audience
|
|
385
|
-
3. **Give the hero agency** - They should drive the adventure, not be dragged along
|
|
386
|
-
4. **Escalate obstacles naturally** - Each challenge should be harder than the last
|
|
387
|
-
5. **Balance spectacle with character** - Amazing sights mean nothing without emotional investment
|
|
388
|
-
6. **Use the journey to transform the hero** - External adventure mirrors internal growth
|
|
389
|
-
7. **Make companions essential** - Each should contribute uniquely to success
|
|
390
|
-
8. **Ground the fantastic in emotion** - Relatable feelings in extraordinary circumstances
|
|
391
|
-
9. **Deliver on the promise of the quest** - The destination should be worth the journey
|
|
392
|
-
10. **Leave room for wonder** - Not everything needs explanation; preserve mystery
|
|
393
|
-
|
|
394
|
-
## Resources
|
|
395
|
-
|
|
396
|
-
- "The Hero with a Thousand Faces" by Joseph Campbell
|
|
397
|
-
- "The Writer's Journey" by Christopher Vogler
|
|
398
|
-
- "Into the Woods: How Stories Work and Why We Tell Them" by John Yorke
|
|
399
|
-
- "Adventure Screenwriting" by Michael Hauge
|
|
400
|
-
- Study: Indiana Jones series, Lord of the Rings trilogy, The Goonies, Jurassic Park, Pirates of the Caribbean
|
|
401
|
-
|
|
402
|
-
---
|
|
403
|
-
|
|
404
|
-
**Depth Coverage**: 85%
|
|
405
|
-
**Last Updated**: 2026-01-31
|
|
406
|
-
**Version**: 1.0.0
|
|
407
|
-
|
|
1
|
+
# Adventure Genre
|
|
2
|
+
|
|
3
|
+
**Category**: Screenplay Genre
|
|
4
|
+
**Type**: Primary
|
|
5
|
+
**Complexity**: Medium
|
|
6
|
+
|
|
7
|
+
## Overview
|
|
8
|
+
|
|
9
|
+
Adventure films follow protagonists on journeys of discovery, featuring exotic locations, treasure hunts, quests, and exploration. The genre emphasizes wonder, discovery, and the thrill of the unknown.
|
|
10
|
+
|
|
11
|
+
## Core Concept
|
|
12
|
+
|
|
13
|
+
Adventure screenplays are built around a journey - physical, emotional, or both. The protagonist leaves their ordinary world to pursue a goal in an extraordinary setting, facing obstacles that test their courage, resourcefulness, and character. Success depends on balancing spectacle with personal growth and maintaining a sense of wonder throughout.
|
|
14
|
+
|
|
15
|
+
## Core Rules
|
|
16
|
+
|
|
17
|
+
### Rule 1: Establish a Clear Quest or Goal
|
|
18
|
+
|
|
19
|
+
**Description**: The protagonist must have a specific, tangible objective that drives the journey forward.
|
|
20
|
+
|
|
21
|
+
**Why It Matters**: Without a clear goal, the adventure becomes aimless wandering. The quest provides structure and purpose.
|
|
22
|
+
|
|
23
|
+
**Examples**:
|
|
24
|
+
- ✅ **Good**: "Find the lost city of gold before the rival expedition"
|
|
25
|
+
- ❌ **Bad**: "Travel around and see what happens"
|
|
26
|
+
|
|
27
|
+
**Film Reference**: Raiders of the Lost Ark (1981) - Indiana Jones must find the Ark of the Covenant before the Nazis.
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
### Rule 2: Create a Journey Structure
|
|
32
|
+
|
|
33
|
+
**Description**: The story should follow a clear geographical and emotional journey with distinct stages and locations.
|
|
34
|
+
|
|
35
|
+
**Why It Matters**: The journey structure provides natural act breaks and escalation. Each new location brings new challenges.
|
|
36
|
+
|
|
37
|
+
**Examples**:
|
|
38
|
+
- ✅ **Good**: Home → First obstacle → Exotic location → Greater challenge → Final destination
|
|
39
|
+
- ❌ **Bad**: All action happens in one location with no sense of progression
|
|
40
|
+
|
|
41
|
+
**Film Reference**: The Lord of the Rings (2001-2003) - Clear journey from Shire to Mordor with distinct stages.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
### Rule 3: Emphasize Discovery and Wonder
|
|
46
|
+
|
|
47
|
+
**Description**: Reveal new worlds, creatures, cultures, or knowledge that amazes both protagonist and audience.
|
|
48
|
+
|
|
49
|
+
**Why It Matters**: Wonder is the emotional core of adventure. Discovery creates excitement and justifies the journey.
|
|
50
|
+
|
|
51
|
+
**Examples**:
|
|
52
|
+
- ✅ **Good**: "They enter the hidden temple, revealing ancient murals and impossible architecture"
|
|
53
|
+
- ❌ **Bad**: "They find a room with some old stuff"
|
|
54
|
+
|
|
55
|
+
**Film Reference**: Jurassic Park (1993) - The first dinosaur reveal creates pure wonder.
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
### Rule 4: Include Diverse Obstacles
|
|
60
|
+
|
|
61
|
+
**Description**: Mix physical challenges, environmental hazards, antagonists, and moral dilemmas throughout the journey.
|
|
62
|
+
|
|
63
|
+
**Why It Matters**: Varied obstacles keep the adventure fresh and test different aspects of the protagonist's character.
|
|
64
|
+
|
|
65
|
+
**Examples**:
|
|
66
|
+
- ✅ **Good**: Treacherous terrain → hostile natives → rival treasure hunters → moral choice about the treasure
|
|
67
|
+
- ❌ **Bad**: The same type of obstacle repeated throughout
|
|
68
|
+
|
|
69
|
+
**Film Reference**: The Mummy (1999) - Combines traps, mummies, rival treasure hunters, and supernatural threats.
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
### Rule 5: Transform the Hero Through the Journey
|
|
74
|
+
|
|
75
|
+
**Description**: The adventure should fundamentally change the protagonist, teaching them something essential about themselves or the world.
|
|
76
|
+
|
|
77
|
+
**Why It Matters**: Physical journey without emotional growth is hollow. The external adventure should mirror internal transformation.
|
|
78
|
+
|
|
79
|
+
**Examples**:
|
|
80
|
+
- ✅ **Good**: Selfish treasure hunter learns the value of friendship and sacrifice
|
|
81
|
+
- ❌ **Bad**: Hero returns home exactly as they left, having learned nothing
|
|
82
|
+
|
|
83
|
+
**Film Reference**: The Wizard of Oz (1939) - Dorothy learns "there's no place like home" through her journey.
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
### Rule 6: Establish High Stakes Beyond Personal Gain
|
|
88
|
+
|
|
89
|
+
**Description**: While personal goals drive the hero, larger stakes should emerge - saving others, preventing catastrophe, or protecting something valuable.
|
|
90
|
+
|
|
91
|
+
**Why It Matters**: Pure self-interest limits audience investment. Higher stakes create urgency and moral weight.
|
|
92
|
+
|
|
93
|
+
**Examples**:
|
|
94
|
+
- ✅ **Good**: Finding the artifact will save the village from destruction
|
|
95
|
+
- ❌ **Bad**: Finding the artifact will make the hero rich (and nothing else matters)
|
|
96
|
+
|
|
97
|
+
**Film Reference**: Indiana Jones and the Last Crusade (1989) - Starts as personal (save father), escalates to global (prevent Nazi immortality).
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
### Rule 7: Create a Worthy Antagonist or Obstacle
|
|
102
|
+
|
|
103
|
+
**Description**: The opposition should be formidable, whether a villain, rival, nature, or the quest itself.
|
|
104
|
+
|
|
105
|
+
**Why It Matters**: Easy victories diminish the adventure. Worthy opposition makes success meaningful.
|
|
106
|
+
|
|
107
|
+
**Examples**:
|
|
108
|
+
- ✅ **Good**: Rival expedition with more resources, or treacherous mountain that has defeated all previous climbers
|
|
109
|
+
- ❌ **Bad**: Easily defeated obstacles that pose no real threat
|
|
110
|
+
|
|
111
|
+
**Film Reference**: The Princess Bride (1987) - Each obstacle (Fezzik, Inigo, Vizzini, Fire Swamp) is uniquely challenging.
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
### Rule 8: Use Exotic or Extraordinary Settings
|
|
116
|
+
|
|
117
|
+
**Description**: Take the audience to places they've never been - geographically, historically, or fantastically.
|
|
118
|
+
|
|
119
|
+
**Why It Matters**: Setting is character in adventure films. Extraordinary locations create visual interest and unique challenges.
|
|
120
|
+
|
|
121
|
+
**Examples**:
|
|
122
|
+
- ✅ **Good**: Ancient ruins in the Amazon, underwater city, alien planet, medieval kingdom
|
|
123
|
+
- ❌ **Bad**: Generic modern city with no distinctive features
|
|
124
|
+
|
|
125
|
+
**Film Reference**: Avatar (2009) - Pandora is a fully realized alien world that drives the adventure.
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
### Rule 9: Include Moments of Camaraderie
|
|
130
|
+
|
|
131
|
+
**Description**: Show the bonds formed between adventurers through shared danger and triumph.
|
|
132
|
+
|
|
133
|
+
**Why It Matters**: Relationships humanize the adventure and provide emotional stakes beyond the quest itself.
|
|
134
|
+
|
|
135
|
+
**Examples**:
|
|
136
|
+
- ✅ **Good**: Quiet campfire scene where characters share stories and bond
|
|
137
|
+
- ❌ **Bad**: Characters remain strangers despite traveling together for weeks
|
|
138
|
+
|
|
139
|
+
**Film Reference**: The Goonies (1985) - Friendship is as important as the treasure hunt.
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
### Rule 10: Balance Realism and Fantasy
|
|
144
|
+
|
|
145
|
+
**Description**: Even in fantastical settings, maintain internal logic and consequences. Ground the extraordinary in relatable emotions.
|
|
146
|
+
|
|
147
|
+
**Why It Matters**: Complete fantasy without grounding loses audience connection. Believable reactions to unbelievable situations create engagement.
|
|
148
|
+
|
|
149
|
+
**Examples**:
|
|
150
|
+
- ✅ **Good**: Characters react with appropriate awe, fear, or skepticism to fantastic elements
|
|
151
|
+
- ❌ **Bad**: Characters accept impossible things without reaction
|
|
152
|
+
|
|
153
|
+
**Film Reference**: Pirates of the Caribbean (2003) - Supernatural elements grounded by character reactions and consequences.
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
## Guidelines
|
|
158
|
+
|
|
159
|
+
### Structure
|
|
160
|
+
|
|
161
|
+
- **Act I**: Ordinary world, call to adventure, refusal, crossing threshold (pages 1-25)
|
|
162
|
+
- **Act II**: Tests and trials, allies and enemies, approach to innermost cave, ordeal (pages 25-85)
|
|
163
|
+
- **Act III**: Reward, road back, resurrection, return with elixir (pages 85-110)
|
|
164
|
+
|
|
165
|
+
### Pacing
|
|
166
|
+
|
|
167
|
+
- Establish ordinary world quickly (5-10 pages)
|
|
168
|
+
- Cross into adventure by page 15-20
|
|
169
|
+
- New location or major discovery every 15-20 pages
|
|
170
|
+
- Build to climactic final challenge
|
|
171
|
+
- Allow brief moments of rest between major obstacles
|
|
172
|
+
|
|
173
|
+
### Character Archetypes
|
|
174
|
+
|
|
175
|
+
- **Protagonist**: Curious, brave, resourceful, often reluctant at first, grows through journey
|
|
176
|
+
- **Mentor**: Wise guide who prepares hero (often dies or departs before final challenge)
|
|
177
|
+
- **Allies**: Diverse companions with complementary skills
|
|
178
|
+
- **Antagonist**: Rival adventurer, tyrant, or force of nature opposing the quest
|
|
179
|
+
- **Threshold Guardian**: Tests hero's worthiness to continue
|
|
180
|
+
|
|
181
|
+
### Tone and Atmosphere
|
|
182
|
+
|
|
183
|
+
- Sense of wonder and possibility
|
|
184
|
+
- Optimistic despite danger
|
|
185
|
+
- Humor balances peril
|
|
186
|
+
- Exotic and immersive
|
|
187
|
+
- Emphasis on discovery over destruction
|
|
188
|
+
|
|
189
|
+
### Visual Style
|
|
190
|
+
|
|
191
|
+
- Sweeping vistas and establishing shots of exotic locations
|
|
192
|
+
- Vibrant color palette
|
|
193
|
+
- Practical locations when possible for authenticity
|
|
194
|
+
- Emphasis on scale and grandeur
|
|
195
|
+
- Visual contrast between ordinary and extraordinary worlds
|
|
196
|
+
|
|
197
|
+
### Dialogue
|
|
198
|
+
|
|
199
|
+
- Exposition through discovery, not explanation
|
|
200
|
+
- Banter and camaraderie between companions
|
|
201
|
+
- Expressions of wonder and awe
|
|
202
|
+
- Cultural or historical flavor appropriate to setting
|
|
203
|
+
- Minimal technical jargon unless it serves character
|
|
204
|
+
|
|
205
|
+
## Common Pitfalls
|
|
206
|
+
|
|
207
|
+
### Pitfall 1: Passive Protagonist
|
|
208
|
+
|
|
209
|
+
**Problem**: Hero is dragged along by events rather than driving the adventure forward.
|
|
210
|
+
|
|
211
|
+
**Solution**: Hero should make active choices that propel the journey. Give them agency and initiative.
|
|
212
|
+
|
|
213
|
+
**Example**: Hero chooses to pursue the quest despite warnings, not because they have no choice.
|
|
214
|
+
|
|
215
|
+
---
|
|
216
|
+
|
|
217
|
+
### Pitfall 2: Travelogue Without Stakes
|
|
218
|
+
|
|
219
|
+
**Problem**: Beautiful locations but no real danger or consequences.
|
|
220
|
+
|
|
221
|
+
**Solution**: Every location should present genuine obstacles. Beauty can coexist with peril.
|
|
222
|
+
|
|
223
|
+
**Example**: The paradise island also has deadly predators and hostile inhabitants.
|
|
224
|
+
|
|
225
|
+
---
|
|
226
|
+
|
|
227
|
+
### Pitfall 3: Convenient Solutions
|
|
228
|
+
|
|
229
|
+
**Problem**: Hero finds exactly what they need exactly when they need it.
|
|
230
|
+
|
|
231
|
+
**Solution**: Make the hero work for solutions. Foreshadow tools and knowledge earlier.
|
|
232
|
+
|
|
233
|
+
**Example**: The rope that saves them in Act III was acquired and mentioned in Act I.
|
|
234
|
+
|
|
235
|
+
---
|
|
236
|
+
|
|
237
|
+
### Pitfall 4: Forgettable Companions
|
|
238
|
+
|
|
239
|
+
**Problem**: Supporting characters are interchangeable and serve no distinct purpose.
|
|
240
|
+
|
|
241
|
+
**Solution**: Give each companion a unique skill, personality, and character arc.
|
|
242
|
+
|
|
243
|
+
**Example**: One is the navigator, one is the fighter, one is the scholar - each essential at different points.
|
|
244
|
+
|
|
245
|
+
---
|
|
246
|
+
|
|
247
|
+
### Pitfall 5: Anticlimactic Discovery
|
|
248
|
+
|
|
249
|
+
**Problem**: The goal of the quest is disappointing or underwhelming when finally reached.
|
|
250
|
+
|
|
251
|
+
**Solution**: Make the discovery worth the journey. Exceed expectations or subvert them meaningfully.
|
|
252
|
+
|
|
253
|
+
**Example**: The treasure is more wondrous than imagined, or the real treasure was the journey itself (if earned).
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
257
|
+
## Film Examples
|
|
258
|
+
|
|
259
|
+
### Example 1: Raiders of the Lost Ark (1981)
|
|
260
|
+
|
|
261
|
+
**Director**: Steven Spielberg
|
|
262
|
+
|
|
263
|
+
**Why It Works**: Perfect adventure structure, charismatic hero, exotic locations, constant forward momentum.
|
|
264
|
+
|
|
265
|
+
**Key Scenes**:
|
|
266
|
+
- **Opening Temple Sequence**: Establishes Indy's skills, love of archaeology, and sense of adventure
|
|
267
|
+
- **Truck Chase**: Escalating action in exotic location with clear stakes
|
|
268
|
+
- **Ark Opening**: Payoff of the quest with spectacular and dangerous results
|
|
269
|
+
|
|
270
|
+
**Techniques Used**:
|
|
271
|
+
- Hero's Journey structure
|
|
272
|
+
- Cliffhanger pacing
|
|
273
|
+
- Practical stunts and locations
|
|
274
|
+
- Balance of humor and danger
|
|
275
|
+
- Clear visual storytelling
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
### Example 2: The Lord of the Rings: The Fellowship of the Ring (2001)
|
|
280
|
+
|
|
281
|
+
**Director**: Peter Jackson
|
|
282
|
+
|
|
283
|
+
**Why It Works**: Epic scope, diverse companions, clear quest, rich world-building, emotional depth.
|
|
284
|
+
|
|
285
|
+
**Key Scenes**:
|
|
286
|
+
- **Shire to Rivendell**: Journey from ordinary to extraordinary world
|
|
287
|
+
- **Mines of Moria**: Peril, loss (Gandalf), and consequence
|
|
288
|
+
- **Breaking of the Fellowship**: Emotional climax as journey fractures
|
|
289
|
+
|
|
290
|
+
**Techniques Used**:
|
|
291
|
+
- Detailed world-building
|
|
292
|
+
- Distinct locations with unique challenges
|
|
293
|
+
- Character growth through adversity
|
|
294
|
+
- Balance of spectacle and intimacy
|
|
295
|
+
- Mythic storytelling
|
|
296
|
+
|
|
297
|
+
---
|
|
298
|
+
|
|
299
|
+
### Example 3: The Princess Bride (1987)
|
|
300
|
+
|
|
301
|
+
**Director**: Rob Reiner
|
|
302
|
+
|
|
303
|
+
**Why It Works**: Perfect blend of adventure, romance, and humor. Quotable dialogue, memorable characters.
|
|
304
|
+
|
|
305
|
+
**Key Scenes**:
|
|
306
|
+
- **Battle of Wits**: Intellectual challenge as adventure obstacle
|
|
307
|
+
- **Fire Swamp**: Environmental hazards test the couple
|
|
308
|
+
- **Storming the Castle**: Climactic rescue with teamwork
|
|
309
|
+
|
|
310
|
+
**Techniques Used**:
|
|
311
|
+
- Fairy tale structure
|
|
312
|
+
- Distinct obstacles requiring different skills
|
|
313
|
+
- Romance integrated into adventure
|
|
314
|
+
- Self-aware humor
|
|
315
|
+
- Satisfying payoffs
|
|
316
|
+
|
|
317
|
+
---
|
|
318
|
+
|
|
319
|
+
### Example 4: Jurassic Park (1993)
|
|
320
|
+
|
|
321
|
+
**Director**: Steven Spielberg
|
|
322
|
+
|
|
323
|
+
**Why It Works**: Wonder and terror balanced perfectly. Science fiction adventure with clear stakes.
|
|
324
|
+
|
|
325
|
+
**Key Scenes**:
|
|
326
|
+
- **First Dinosaur Reveal**: Pure wonder and awe
|
|
327
|
+
- **T-Rex Attack**: Terror in paradise
|
|
328
|
+
- **Raptor Kitchen**: Suspenseful climax
|
|
329
|
+
|
|
330
|
+
**Techniques Used**:
|
|
331
|
+
- Build wonder before introducing danger
|
|
332
|
+
- Science grounds the fantastic
|
|
333
|
+
- Children in peril raise stakes
|
|
334
|
+
- Practical effects create reality
|
|
335
|
+
- Clear cause and effect
|
|
336
|
+
|
|
337
|
+
---
|
|
338
|
+
|
|
339
|
+
### Example 5: The Goonies (1985)
|
|
340
|
+
|
|
341
|
+
**Director**: Richard Donner
|
|
342
|
+
|
|
343
|
+
**Why It Works**: Kid-friendly adventure with real stakes, treasure hunt structure, strong friendships.
|
|
344
|
+
|
|
345
|
+
**Key Scenes**:
|
|
346
|
+
- **Attic Discovery**: Call to adventure through found map
|
|
347
|
+
- **Underground Traps**: Escalating obstacles in exotic setting
|
|
348
|
+
- **Pirate Ship**: Reward and wonder
|
|
349
|
+
|
|
350
|
+
**Techniques Used**:
|
|
351
|
+
- Ensemble cast with distinct personalities
|
|
352
|
+
- Treasure hunt provides clear structure
|
|
353
|
+
- Humor and heart balance danger
|
|
354
|
+
- Coming-of-age through adventure
|
|
355
|
+
- Friendship as important as treasure
|
|
356
|
+
|
|
357
|
+
---
|
|
358
|
+
|
|
359
|
+
## Integration with Other Features
|
|
360
|
+
|
|
361
|
+
### Compatible Themes
|
|
362
|
+
|
|
363
|
+
- **Growth**: Hero matures through journey (The Goonies)
|
|
364
|
+
- **Friendship**: Bonds formed through shared adventure (Lord of the Rings)
|
|
365
|
+
- **Identity**: Hero discovers who they truly are (The Wizard of Oz)
|
|
366
|
+
- **Survival**: Physical journey tests limits (The Revenant)
|
|
367
|
+
|
|
368
|
+
### Compatible Styles
|
|
369
|
+
|
|
370
|
+
- **Epic**: Large-scale adventure across vast landscapes (Lord of the Rings)
|
|
371
|
+
- **Linear**: Clear journey from point A to point B (Raiders of the Lost Ark)
|
|
372
|
+
- **Ensemble**: Group of adventurers with shared goal (The Goonies)
|
|
373
|
+
|
|
374
|
+
### Hybrid Combinations
|
|
375
|
+
|
|
376
|
+
- **Action-Adventure**: Heavy emphasis on physical conflict (Indiana Jones series)
|
|
377
|
+
- **Fantasy-Adventure**: Magical elements and mythical quests (The NeverEnding Story)
|
|
378
|
+
- **Sci-Fi Adventure**: Space exploration and alien worlds (Star Wars, Avatar)
|
|
379
|
+
- **Comedy-Adventure**: Humor-driven adventure (The Princess Bride, Romancing the Stone)
|
|
380
|
+
|
|
381
|
+
## Best Practices
|
|
382
|
+
|
|
383
|
+
1. **Start with a compelling call to adventure** - Make the quest irresistible
|
|
384
|
+
2. **Create a vivid, immersive world** - Transport the audience
|
|
385
|
+
3. **Give the hero agency** - They should drive the adventure, not be dragged along
|
|
386
|
+
4. **Escalate obstacles naturally** - Each challenge should be harder than the last
|
|
387
|
+
5. **Balance spectacle with character** - Amazing sights mean nothing without emotional investment
|
|
388
|
+
6. **Use the journey to transform the hero** - External adventure mirrors internal growth
|
|
389
|
+
7. **Make companions essential** - Each should contribute uniquely to success
|
|
390
|
+
8. **Ground the fantastic in emotion** - Relatable feelings in extraordinary circumstances
|
|
391
|
+
9. **Deliver on the promise of the quest** - The destination should be worth the journey
|
|
392
|
+
10. **Leave room for wonder** - Not everything needs explanation; preserve mystery
|
|
393
|
+
|
|
394
|
+
## Resources
|
|
395
|
+
|
|
396
|
+
- "The Hero with a Thousand Faces" by Joseph Campbell
|
|
397
|
+
- "The Writer's Journey" by Christopher Vogler
|
|
398
|
+
- "Into the Woods: How Stories Work and Why We Tell Them" by John Yorke
|
|
399
|
+
- "Adventure Screenwriting" by Michael Hauge
|
|
400
|
+
- Study: Indiana Jones series, Lord of the Rings trilogy, The Goonies, Jurassic Park, Pirates of the Caribbean
|
|
401
|
+
|
|
402
|
+
---
|
|
403
|
+
|
|
404
|
+
**Depth Coverage**: 85%
|
|
405
|
+
**Last Updated**: 2026-01-31
|
|
406
|
+
**Version**: 1.0.0
|
|
407
|
+
|