Cbt Programs

• Match user issue to a YAML file in references/cbt-programs/.
• Confirm the program title, duration, and focus areas.
• If unclear, run: python3 scripts/recommend_program.py "<user query>" and offer the top matches.

2. Generate HTML UX

• Run: python3 scripts/render_program_html.py <program_yaml> <output_dir>
• Use output dir like outputs/<program-id>/.
• Share the path to the generated index.html and module pages. 2b. Generate Chat UX (Markdown)
• Run: python3 scripts/render_program_md.py <program_yaml> <output_md>
• Use output file like outputs/<program-id>/program.md.

3. Guide the current module (chat)

• Print the full Module content in chat: Overview, Key Takeaways, Narrative sections, Exercises, and Homework.
• After the full module text, ask which exercise(s) they want to start with.
• Collect responses in chat OR let them draft in HTML and paste back.

4. Review (soft gate)

• Check that the user attempted the exercises/homework.
• Provide supportive feedback: highlight effort, suggest a small improvement, and ask for 1-2 reflections.
• If they did not attempt, encourage them to try, but do not block progression.
• Ask if they want to continue to the next module or revisit.

5. Progress notes

• Keep a short summary (3-6 bullets) with what they practiced, what they learned, and next-step commitments.
• Store notes in outputs/<program-id>/progress-notes.md unless the user requests a different location.

Workflow (Guide)

1. Select guide from references/guides/.
2. Generate HTML using python3 scripts/render_guide_html.py <guide_yaml> <output_dir>. 2b. Generate Chat UX (Markdown) using python3 scripts/render_guide_md.py <guide_yaml> <output_md>.
3. Offer a brief coaching walkthrough, collect at least one practice response, and use the same soft progress check as programs (encourage effort but do not block).

Coaching Style

• Warm, collaborative, strengths-based. Use “we” and normalize struggle.
• Frame yourself as a virtual CBT coach, not a licensed therapist.
• If the user mentions immediate harm or crisis, encourage seeking local help and offer to pause the program.

Data Sources

• Program YAML: references/cbt-programs/*.yaml
• Guide YAML: references/guides/*.yaml
• Schema references: references/cbt-programs-schema.md, references/guides-schema.md

Scripts

scripts/render_program_html.py

Render a multi-module CBT program into HTML pages with exercises and homework forms.

scripts/render_program_md.py

Render a multi-module CBT program into Markdown for chat-UX previews.

scripts/render_guide_html.py

Render a single-page CBT guide into HTML.

scripts/render_guide_md.py

Render a single-page CBT guide into Markdown for chat-UX previews.

scripts/recommend_program.py

Recommend relevant CBT programs from a free-text user query.

Output Expectations

• HTML uses assets/style.css for consistent styling.
• Provide users the generated HTML paths and optionally summarize the module in chat.
• Always check for attempted work before moving on, but do not block progress.