skills/hq-tech-strategy/SKILL.md
Use when making technology architecture decisions for Sharkitect operations, evaluating build-vs-buy for platforms/tools, assessing security tiering for new integrations, applying the MVA (Minimal Viable Architecture) principle, or when the user asks about tech stack decisions, platform selection, or technology risk assessment. NEVER use for generic software architecture without Sharkitect business context (use senior-architect skill), generic CTO advisory without specific tech decisions (use cto-advisor skill), or AI/LLM system design (use ai-systems-architect agent).
npx skillsauth add sharkitect-solutions/sharkitect-claude-toolkit hq-tech-strategyInstall 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.
| File | Load When | Do NOT Load |
|------|-----------|-------------|
| references/mva-methodology.md | Evaluating whether to build, buy, or wait on a technology | Already decided on approach, just need implementation |
| references/security-tiers.md | Assessing new integrations, APIs, or data flows for security classification | Internal-only changes with no external data exposure |
| references/tech-stack.md | Making platform decisions, evaluating alternatives, or auditing current stack | Generic technology questions unrelated to Sharkitect |
Launch these agents via Task tool for execution:
ai-systems-architect — AI/LLM architecture decisions, model selection, agent pipeline designbackend-architect — API design, service architecture, scalability decisionsdevops-engineer — Infrastructure, CI/CD, deployment architecturemcp-server-architect — MCP server design and implementationUse this skill directly for:
Core rule: Build the smallest defensible system. Document the expansion path. Never build for scale you haven't proven you need.
TECHNOLOGY DECISION
|
+-- Define the OBJECTIVE (what problem are we solving?)
|
+-- Map CURRENT STATE (what do we already have?)
| |
| +-- Can existing tools solve this? --> YES: Use them. STOP.
| |
| +-- NO: Continue to MVA assessment
|
+-- MVA Assessment:
| 1. What is the SMALLEST system that solves the objective?
| 2. What is the EXPANSION PATH if demand grows?
| 3. What is the COST of building now vs. waiting?
| 4. What is the RISK of not building now?
|
+-- Decision:
BUILD: Cost of waiting > Cost of building, AND risk is material
BUY: Existing solution covers 80%+, customization is minor
WAIT: Demand is unproven, cost of waiting is low
| Tier | Classification | Access Pattern | Examples | |------|---------------|----------------|----------| | Tier 0 | Public | Read-only, no auth | Marketing site, public docs | | Tier 1 | Internal | Authenticated, team access | Internal tools, dashboards, KPIs | | Tier 2 | Confidential | Role-based, audit-logged | Client data, financial records, proposals | | Tier 3 | Critical | Encrypted, MFA, immediate escalation | API keys, credentials, payment data, PII |
Classification Rule: When uncertain, classify ONE TIER HIGHER. Downgrading is easy; a breach from under-classification is not.
Tier 3 Escalation: Any Tier 3 data handling requires explicit user approval before implementation. No exceptions.
development
When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ad copy,' 'ad creative,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' or 'audience targeting.' This skill covers campaign strategy, ad creation, audience targeting, and optimization.
testing
--- name: using-sharkitect-methodology description: Use when starting any conversation in a Sharkitect workspace OR before any task involving NEW pricing, positioning, proposal, strategy, plan-execution, or schema-design work — mandates invocation of Sharkitect-specific methodology skills (pricing-strategy, marketing-strategy-pmm, smb-cfo, hq-revenue-ops, executing-plans, brainstorming) under the same anti-rationalization discipline as using-superpowers. Documentation has failed 4 times across H
testing
Use when user says 'end session', 'wrap up', 'stop for the day', 'done for today', 'close out', 'save session', 'wrapping up', or invokes /end-session. Runs the full 9-step end-of-session protocol: resource audit, MEMORY.md update, lessons capture, plan status, pending items, workspace checklist, .tmp/ audit, git commit+push, Supabase brain sync, session brief, summary. Final step schedules a detached self-kill of the current session ONLY (3s delay) so the window closes cleanly. Other claude.exe processes (active workspaces) are NOT touched -- orphan cleanup is handled separately by Claude-Orphan-Cleanup-Hourly with proper age safeguards. Do NOT use for: mid-session quick saves (use session-checkpoint), skill syncing (use sync-skills.py), brain memory queries (use supabase-sync.py pull), document freshness reviews (use document-lifecycle), resource gap detection (use resource-auditor).
testing
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, passive voice, negative parallelisms, and filler phrases.