.cursor/skills/guardrails/SKILL.md
Validation pipeline and quality gates for the Conscius project. Use this skill when a task enters review state, running the guardrails pipeline, checking code quality before a PR, or understanding what quality checks are required. Triggers on tasks involving guardrails, review, validation pipeline, quality gate, pre-PR checks, or entering review.
npx skillsauth add jwill9999/conscius guardrailsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Tasks follow this lifecycle: todo → in_progress → review → done.
On entering review, run the full validation pipeline in order:
| Step | Command | Must pass before proceeding |
| ---------------------- | ---------------------------------------------------- | ----------------------------- |
| 1. Format | npx nx format:write | No uncommitted format changes |
| 2. Lint | npx nx lint <project> | Zero errors |
| 3. Typecheck | npx nx typecheck <project> | Zero errors |
| 4. Unit tests | npx nx test <project> | All tests pass |
| 5. Full suite (pre-PR) | npx nx run-many -t typecheck,lint,test,build --all | All packages pass |
| 6. Agent review | Read PR comments for SonarCloud + Sourcery feedback | Quality Gate passed |
If any step fails: fix issues → rerun from that step.
| Tool | Purpose | Runs on |
| --------------------------------------------- | --------------------------------------------------------- | ------------------------- |
| Nx (typecheck, lint, test, build) | Local quality gates | Every task branch, pre-PR |
| Sourcery AI | Automated PR code review, architecture diagrams | Every PR (GitHub bot) |
| SonarCloud | Static analysis, security hotspots, coverage, duplication | Every PR + main |
# Format
npx nx format:write
# Single project
npx nx run-many -t typecheck,lint,test --projects=<project>
# All projects (pre-epic-PR)
npx nx run-many -t typecheck,lint,test,build --all
# Affected only (faster on feature branches)
npx nx affected -t typecheck,lint,test
testing
Manage SESSION.md and SUMMARY.md for the Conscius project. USE WHEN: user says 'update session', 'update SESSION.md', 'end of session', 'taking a break', 'stepping away', 'compress conversation', 'add summary', or when completing an epic/task and session state needs recording. EXAMPLES: 'update the session', 'let's update session.md', 'add a summary segment', 'I am done for today'.
testing
PR review workflow for the Conscius project. USE WHEN: user opens a pull request, asks to check CI status, mentions SonarCloud or Sourcery feedback, asks if a PR is ready to merge, or needs to resolve a merge conflict. EXAMPLES: 'check if the PR is ready', 'CI failed on my PR', 'SonarCloud flagged something', 'is this ready to merge?', 'fix merge conflict', 'review PR feedback'.
tools
Plan, document, and manage epics, features, tasks, and backlog items for the Conscius project. Creates entries in both the markdown planning docs (docs/planning/) and the Beads task graph (bd CLI). Use this skill for all planning work. Supported slash commands: /new-epic, /new-feature, /add-task, /update-status, /close-feature, /archive-feature, /new-backlog, /move-to-feature, /list-features, /list-backlog, /sync-beads, /help /planning
development
Explore and understand Nx workspaces. USE WHEN answering questions about the workspace, projects, or tasks. ALSO USE WHEN an nx command fails or you need to check available targets/configuration before running a task. EXAMPLES: 'What projects are in this workspace?', 'How is project X configured?', 'What depends on library Y?', 'What targets can I run?', 'Cannot find configuration for task', 'debug nx task failure'.