skills/cali-product-workflow/skills-workflow/cali-tech-planning/SKILL.md
[Cali] Technical planning and scope sequencing skill. Generates typed scopes (feature/optimization/spike), sequences them, and creates progress tracking units. Can be used standalone or as part of cali-product-workflow.
npx skillsauth add renatocaliari/agent-sync-public-skills cali-tech-planningInstall 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.
This skill executes the Tech Planning phase. It can be used:
Approval check: Read the YAML frontmatter of spec-product.md:
approved: true → proceedapproved: true → GO BACK to Review Gate. Do not proceed.This check is deterministic — do not rely on memory, read the YAML frontmatter.
Read the references/ files to guide the process:
| File | Covers | When to read |
|---|---|---|
| references/TECH-CONTEXT.md | Tech planning context, prerequisites, workflow position | Before starting — sets planning context |
| references/SCOPES-AND-SEQUENCING.md | Scope types (feature/optimization/spike), executor routing, sequencing principles | During generation — defines scope structure |
| references/TECH-OUTPUT.md | Tech plan output format, frontmatter, receipts | After generation — formats output |
| references/generation-principles.md | Generation principles, constraints, quality standards | During generation — guides implementation |
Use the references above to generate technical scopes:
.cali-product-workflow/{YYYY-MM-DD}/{_dir}/plans/spec-tech_{v}.mdEach scope must have:
feature, optimization, or spikeIf Tech Planning is standalone (not preceded by Shape Up):
.approvals/{_dir}/spec-tech_{v}.approved.mdapproved: true in spec-tech.md frontmatterIf post-Shape-Up: the gate already ran in Review Gate phase — skip this step.
After tech plan approval, convert each scope into a trackable unit with completion criteria:
Tech plan is saved to:
.cali-product-workflow/{YYYY-MM-DD}/{_dir}/plans/spec-tech_{v}.md
If any capability is unavailable, adapt using whatever tools your environment provides.
development
PocketBase v0.39+ development - API rules, auth, collections, SDK, realtime, files, Go/JS extending, deployment, production tuning.
tools
Auto-initialize structured documentation for any project using lat.md (knowledge graph of markdown files with [[wiki links]], // @lat: code refs, and semantic search). Detects cali-product-workflow artifacts (spec-product.md, spec-tech.md, critiques) and uses them as seed material. Falls back to extracting business rules, architecture, and design decisions directly from the codebase. Use when a project lacks structured documentation or when lat.md/ is missing. After seeding, lat.md extension hooks keep documentation alive automatically.
testing
[Cali] Server security audit and hardening for private servers behind Tailscale. Use when: auditing server security, hardening SSH/firewall/Docker, checking for vulnerabilities, setting up fail2ban, reviewing port exposure, or responding to security alerts. Covers 6 layers: CloudFlare, UFW, Tailscale, SSH, Docker, Application. Triggers: "server security", "security audit", "harden server", "SSH hardening", "firewall rules", "UFW config", "fail2ban", "port security", "Docker security", "vulnerability check", "security review".
tools
Run supply chain security scans before installing packages or before releases. Triggers when: user installs a package (npm, pip, go get, brew), user asks to 'scan dependencies', 'check vulnerabilities', 'supply chain', 'security audit', 'run trivy', 'run socket', or before any release/deployment. Also triggers on mentions of: socket.dev, trivy, OSV-scanner, dotenvx, CVE, dependency audit. Covers all four tools with concrete commands.