chore: add AI agents docs and skills

[simeonoff]

Summary

This PR extends the internal AI workflow with two additional specialized agents:

• a demo/sample agent for optional user-visible demo follow-through
• a theming/styles agent for SCSS, theme wiring, and style validation work

It also updates the existing feature and bug-fix workflows so these agents are used only when the task actually requires them.

Why

The goal of these changes is to separate demo and styling follow-through from general implementation work.

This keeps production-code agents more focused, makes theming and style changes more consistent with the repository’s SCSS and theme-system rules, and ensures demo/sample updates happen only when they are explicitly wanted.

What changed

Updated

• .github/agents/feature-orchestrator-agent.md

  • Extends the feature workflow to recognize theming/style follow-through as a separate concern.
  • Adds an explicit demo/sample decision point so demo updates happen only when the user asks for them.

• .github/agents/bug-fixing-orchestrator-agent.md

  • Extends the bug-fix workflow with dedicated handling for theming and style-related fixes.
  • Adds an explicit demo/sample decision point for user-visible fixes so demo updates remain optional.

• .github/agents/feature-implementer-agent.md

  • Clarifies that general feature implementation does not own component SCSS or theme infrastructure changes.

• .github/agents/bug-fixing-implementer-agent.md

  • Clarifies that general bug-fix implementation does not own component SCSS or theme infrastructure changes.

Added

• .github/agents/demo-sample-agent.md

  • Defines the demo/sample update agent.
  • Used to update existing demo/sample areas under src/app/ when a demo is explicitly requested for a user-visible feature or bug fix.
  • Helps keep demos aligned with the real implementation while reusing the existing sample structure instead of creating parallel showcase content.

• .github/agents/theming-styles-agent.md

  • Defines the theming and styles agent.
  • Used to implement SCSS, theme wiring, and style-validation changes in the in-repo styling system.
  • Helps keep visual changes aligned with the repository’s theming architecture, shared style rules, and style validation workflow.

Result

Together, these changes extend the internal AI workflow with two additional follow-through paths:

• dedicated handling for theming and styling work
• optional demo/sample updates for user-visible changes

This should make AI-assisted changes more modular, reduce overlap between implementation and styling responsibilities, and keep demo work intentional instead of automatic.

Notes

• These changes build on the earlier agent workflow setup and focus only on the newly added demo/sample and theming/styles paths.
• Demo/sample updates are intentionally optional and should be performed only when explicitly requested.
• Theming and styling work is intentionally separated from general implementation so SCSS and theme-system changes follow the repository’s existing styling conventions and validation steps.