srat

Test on the Homeassitant Dev envoronment

Review the current chat session or recently completed task for reusable implementation or testing lessons, then decide whether to update an existing GitHub instruction and skills, create a new instruction/skill, or store the guidance as repo memory. Use when: finishing a fix, stabilizing a test, capturing a lesson learned, or asking "should we document this for future Copilot sessions?" Triggers on: "lesson learned", "capture lessons learned", "review session for reusable pattern", "update github instruction", "document this fix for future".

Close out a completed docs/tasks/*.md task by validating checklist completion, syncing GitHub issue status/comments, and preparing optional PR summary notes. Triggers on: "close task", "finalize task", "wrap up task 012", "complete docs task".

Automate creation or update of a pull request from the current branch to main, with detailed PR body, task/issue linking, and user prompts for draft/auto-merge. Fallback to commit summary if no task is found.

Create a new task planning document for SRAT. Use when: adding a feature, planning a fix, documenting a refactor, or creating a new TODO item. Produces a <TaskID>_<Title>.md file in docs/tasks/ using the project task template. Triggers on: "create task", "new task", "add task", "plan feature", "create todo", "new issue task", "document work item".

Expert HomeAssistant development skill for creating custom sensors (template, REST, command line, Python components), building Lovelace dashboards with custom cards and layouts, and developing custom integrations with config flows, coordinators, and multiple platforms. Use this skill when working with HomeAssistant YAML configuration, Python integration development, or dashboard customization.

Execute one checklist phase from a docs/tasks/*.md task with strict sequencing: pick exactly one unchecked item, implement only that scope, run targeted validation, and update task progress immediately. Triggers on: "implement next task item", "do task phase", "work on next checklist item", "execute phase 3 of task 012".

Guided pre/post test safety harness for code refactors. Before any refactor, ask the user whether to run a "prepare check": identify all impacted functions (even those not directly modified), ensure each has a test, create missing tests, record pre-refactor test state in a tracking doc under docs/refactors/, then run the same tests after the refactor and verify nothing broke. Triggers on: "prepare refactor", "refactor check", "refactor safety check", "pre refactor", "prepare and check refactor", or whenever a task type is REFACTOR.

Start implementation from a docs/tasks/*.md file with guardrails: verify/create linked GitHub issue in dianlight/srat, branch from main when needed, inspect code and produce a plan summary before coding, and keep the task doc updated at every phase. Supports strict mode to require a numeric task ID. Triggers on: "start task", "work on task", "begin task 012", "implement docs task", "start implementation from docs/tasks".

Sync docs/tasks/*.md planning documents with GitHub issues and in-code TODO/FIXME annotations. THREE modes: (1) IMPORT — pull open issues from dianlight/srat and dianlight/hassio-addons (SambaNAS2 only) into task files; (2) EXPORT — push task progress to GitHub (comment/close/create); (3) CODE-SCAN — read TODO/FIXME comments from code to enrich matching tasks or create new ones. Triggers on: "sync tasks", "sync github", "import issues", "export task status", "update tasks from issues", "push task progress", "close issue from task", "sync todos", "import fixme".

Generate a Markdown progress report of all tasks in docs/tasks/ grouped by status (📅 Planned / 🔄 In Progress / ✅ Complete). Optionally filter by type (FEATURE/FIX/DOCS/REFACTOR) or linked repo. Output is suitable for a weekly standup, GitHub comment, or PR description. Triggers on: "task status", "show task progress", "what tasks are done", "weekly standup", "task report", "progress report", "list tasks".

Read completed or updated tasks from docs/tasks/ and append structured entries to CHANGELOG.md under the [ 🚧 Unreleased ] section, following the existing changelog format. Triggers on: "update changelog", "add to changelog", "changelog from tasks", "generate release notes", "write changelog entry".

Update CHANGELOG.md from completed tasks AND important commits since last release. Combines task-based entries with commit-based entries, prioritizing by lines changed. Triggers on: "update changelog with commits", "changelog from tasks and commits", "generate release notes with git".

Observe a human-driven SRAT remote test session without taking over the UI. Reuses or opens the frontend at `http://localhost:3080/`, waits while the user manually navigates and clicks, records the user's actions, and concurrently monitors browser console/network plus frontend/backend/Home Assistant logs. If an error or strange effect appears, asks whether to ignore it or attempt a fix, then can start a focused autonomous subtask to investigate, implement a fix, verify it, and ask the user to retry. Triggers on: 'watch my testing', 'watch manual test', 'manual remote test', 'observe while I click around', 'monitor browser and backend logs', 'I will test manually, watch for errors'.