Custom Amp Demos

A curated set of realistic demo projects to showcase Amp across common enterprise use cases. Includes multi-language stacks, mock datasets, reusable tools, and end-to-end demo flows.

• Quick start: scripts/setup_all.sh
• Choose a demo: see MASTER_DEMOS.md
• Run projects: each project has scripts/dev.sh, scripts/test.sh, scripts/lint.sh, scripts/ci.sh
• Enable tools: see AMP_TOOLBOX/README.md
• Large-context tips: see AGENTS.md
• JetBrains usage: JETBRAINS.md

Quick start

1. Clone the repo
2. ./scripts/setup_all.sh
3. Open MASTER_DEMOS.md and pick a flow

Projects

See PROJECTS.json for metadata and DEMO_FLOWS.md in each project for step-by-step flows.

Scenario Engine (MVP)

Prereqs: Node 20 LTS. Setup: npm install at repo root.

Key files:

• Schema: docs/SCHEMA/scenario.schema.json
• Playbook template: docs/PLAYBOOK_TEMPLATES/playbook.md.hbs
• CLI: scripts/scenario_engine.ts
• Plan: docs/EXTENSIBILITY_PLAN.md
• Customization guide: docs/SCENARIO_CUSTOMIZATION_GUIDE.md
• Sample: projects/01-node-express-ecommerce/scenario.yml

Commands:

• Validate all scenarios: npm run scenario:validate
• Render playbooks to docs/generated/: npm run scenario:render
• Run a scenario: npm run scenario:run node-cart-autotest
• Enrich customer intel: npm run scenario -- enrich "Acme Corp" -o docs/generated/research/acme.md
  • Optional env: SF_INSTANCE_URL, SF_ACCESS_TOKEN, GITHUB_TOKEN

Authoring:

• Create projects//scenario.yml (conforms to schema) and talktracks under projects//talktracks/.
• List required tools in toolbox that exist in AMP_TOOLBOX/toolbox.config.json.
• Validate and render before PRs.

CI:

• .github/workflows/demo-ci.yml discovers scenario.yml files, validates, renders playbooks, and uploads docs/generated/ as an artifact.

Notes:

• docs/generated/ and .telemetry/ are ignored by git.

Demo Customization System

Tailor demos in minutes with a JSON profile.

• Manual: docs/DEMO_CUSTOMIZATION_MANUAL.md
• Prereqs: Node 18+, AMP_TOOLBOX on PATH
  • Schema: config/customer_profile.schema.json
  • Use-case mapping: config/use_case_mapping.json
  • Example profiles: config/profiles/
• Core commands:
  • Copy/edit profile: cp config/profiles/example_fintech.json my_target.json
  • Validate: npx ajv -s config/customer_profile.schema.json -d my_target.json
  • Generate plan + talk track: node AMP_TOOLBOX/tools/demo_customizer.mjs --file my_target.json --duration 20 --out /tmp/custom_demo.json
  • Optional SFDC-style enrich: node AMP_TOOLBOX/tools/profile_loader.mjs --file my_target.json > /tmp/enriched.json
• Output: top-3 recommended projects with reasons, talk_track, and demo_flows; scoring considers use-cases, tech stack, audience, and duration.
• Tips: pipe through jq (e.g., jq '.talk_track' /tmp/custom_demo.json); adjust use-cases and rerun for live re-scoring.