arkaos 2.0.0 → 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/README.md +100 -74
  2. package/VERSION +1 -1
  3. package/bin/arkaos +1 -1
  4. package/config/constitution.yaml +4 -0
  5. package/config/hooks/user-prompt-submit-v2.sh +20 -38
  6. package/core/__pycache__/__init__.cpython-313.pyc +0 -0
  7. package/core/agents/__pycache__/__init__.cpython-313.pyc +0 -0
  8. package/core/agents/__pycache__/loader.cpython-313.pyc +0 -0
  9. package/core/agents/__pycache__/schema.cpython-313.pyc +0 -0
  10. package/core/agents/__pycache__/validator.cpython-313.pyc +0 -0
  11. package/core/budget/__init__.py +6 -0
  12. package/core/budget/__pycache__/__init__.cpython-313.pyc +0 -0
  13. package/core/budget/__pycache__/manager.cpython-313.pyc +0 -0
  14. package/core/budget/__pycache__/schema.cpython-313.pyc +0 -0
  15. package/core/budget/manager.py +193 -0
  16. package/core/budget/schema.py +82 -0
  17. package/core/conclave/__pycache__/__init__.cpython-313.pyc +0 -0
  18. package/core/conclave/__pycache__/advisor_db.cpython-313.pyc +0 -0
  19. package/core/conclave/__pycache__/display.cpython-313.pyc +0 -0
  20. package/core/conclave/__pycache__/matcher.cpython-313.pyc +0 -0
  21. package/core/conclave/__pycache__/persistence.cpython-313.pyc +0 -0
  22. package/core/conclave/__pycache__/profiler.cpython-313.pyc +0 -0
  23. package/core/conclave/__pycache__/prompts.cpython-313.pyc +0 -0
  24. package/core/conclave/__pycache__/schema.cpython-313.pyc +0 -0
  25. package/core/governance/__pycache__/__init__.cpython-313.pyc +0 -0
  26. package/core/governance/__pycache__/constitution.cpython-313.pyc +0 -0
  27. package/core/obsidian/__init__.py +6 -0
  28. package/core/obsidian/__pycache__/__init__.cpython-313.pyc +0 -0
  29. package/core/obsidian/__pycache__/templates.cpython-313.pyc +0 -0
  30. package/core/obsidian/__pycache__/writer.cpython-313.pyc +0 -0
  31. package/core/obsidian/templates.py +76 -0
  32. package/core/obsidian/writer.py +148 -0
  33. package/core/orchestration/__init__.py +6 -0
  34. package/core/orchestration/__pycache__/__init__.cpython-313.pyc +0 -0
  35. package/core/orchestration/__pycache__/patterns.cpython-313.pyc +0 -0
  36. package/core/orchestration/__pycache__/protocol.cpython-313.pyc +0 -0
  37. package/core/orchestration/patterns.py +136 -0
  38. package/core/orchestration/protocol.py +96 -0
  39. package/core/registry/__pycache__/__init__.cpython-313.pyc +0 -0
  40. package/core/registry/__pycache__/generator.cpython-313.pyc +0 -0
  41. package/core/runtime/__pycache__/__init__.cpython-313.pyc +0 -0
  42. package/core/runtime/__pycache__/base.cpython-313.pyc +0 -0
  43. package/core/runtime/__pycache__/claude_code.cpython-313.pyc +0 -0
  44. package/core/runtime/__pycache__/codex_cli.cpython-313.pyc +0 -0
  45. package/core/runtime/__pycache__/cursor.cpython-313.pyc +0 -0
  46. package/core/runtime/__pycache__/gemini_cli.cpython-313.pyc +0 -0
  47. package/core/runtime/__pycache__/registry.cpython-313.pyc +0 -0
  48. package/core/runtime/__pycache__/subagent.cpython-313.pyc +0 -0
  49. package/core/specs/__pycache__/__init__.cpython-313.pyc +0 -0
  50. package/core/specs/__pycache__/manager.cpython-313.pyc +0 -0
  51. package/core/specs/__pycache__/schema.cpython-313.pyc +0 -0
  52. package/core/squads/__pycache__/__init__.cpython-313.pyc +0 -0
  53. package/core/squads/__pycache__/loader.cpython-313.pyc +0 -0
  54. package/core/squads/__pycache__/registry.cpython-313.pyc +0 -0
  55. package/core/squads/__pycache__/schema.cpython-313.pyc +0 -0
  56. package/core/synapse/__pycache__/__init__.cpython-313.pyc +0 -0
  57. package/core/synapse/__pycache__/cache.cpython-313.pyc +0 -0
  58. package/core/synapse/__pycache__/engine.cpython-313.pyc +0 -0
  59. package/core/synapse/__pycache__/layers.cpython-313.pyc +0 -0
  60. package/core/tasks/__pycache__/__init__.cpython-313.pyc +0 -0
  61. package/core/tasks/__pycache__/manager.cpython-313.pyc +0 -0
  62. package/core/tasks/__pycache__/schema.cpython-313.pyc +0 -0
  63. package/core/tasks/schema.py +6 -0
  64. package/core/workflow/__pycache__/__init__.cpython-313.pyc +0 -0
  65. package/core/workflow/__pycache__/engine.cpython-313.pyc +0 -0
  66. package/core/workflow/__pycache__/loader.cpython-313.pyc +0 -0
  67. package/core/workflow/__pycache__/schema.cpython-313.pyc +0 -0
  68. package/core/workflow/engine.py +44 -0
  69. package/core/workflow/schema.py +1 -0
  70. package/departments/dev/skills/agent-design/SKILL.md +4 -0
  71. package/departments/dev/skills/agent-design/references/architecture-patterns.md +223 -0
  72. package/departments/dev/skills/ai-security/SKILL.md +4 -0
  73. package/departments/dev/skills/ai-security/references/prompt-injection-catalog.md +230 -0
  74. package/departments/dev/skills/ci-cd-pipeline/SKILL.md +4 -0
  75. package/departments/dev/skills/ci-cd-pipeline/references/github-actions-patterns.md +202 -0
  76. package/departments/dev/skills/db-schema/SKILL.md +4 -0
  77. package/departments/dev/skills/db-schema/references/indexing-strategy.md +197 -0
  78. package/departments/dev/skills/dependency-audit/SKILL.md +4 -0
  79. package/departments/dev/skills/dependency-audit/references/license-matrix.md +191 -0
  80. package/departments/dev/skills/incident/SKILL.md +4 -0
  81. package/departments/dev/skills/incident/references/severity-playbook.md +221 -0
  82. package/departments/dev/skills/observability/SKILL.md +4 -0
  83. package/departments/dev/skills/observability/references/slo-design.md +200 -0
  84. package/departments/dev/skills/rag-architect/SKILL.md +5 -0
  85. package/departments/dev/skills/rag-architect/references/chunking-strategies.md +129 -0
  86. package/departments/dev/skills/rag-architect/references/evaluation-guide.md +158 -0
  87. package/departments/dev/skills/red-team/SKILL.md +4 -0
  88. package/departments/dev/skills/red-team/references/mitre-attack-web.md +165 -0
  89. package/departments/dev/skills/security-audit/SKILL.md +4 -0
  90. package/departments/dev/skills/security-audit/references/owasp-2025-deep.md +409 -0
  91. package/departments/dev/skills/security-compliance/SKILL.md +117 -0
  92. package/departments/finance/skills/ciso-advisor/SKILL.md +4 -0
  93. package/departments/finance/skills/ciso-advisor/references/compliance-roadmap.md +172 -0
  94. package/departments/marketing/skills/programmatic-seo/SKILL.md +4 -0
  95. package/departments/marketing/skills/programmatic-seo/references/template-playbooks.md +289 -0
  96. package/departments/ops/skills/gdpr-compliance/SKILL.md +104 -0
  97. package/departments/ops/skills/iso27001/SKILL.md +113 -0
  98. package/departments/ops/skills/quality-management/SKILL.md +118 -0
  99. package/departments/ops/skills/risk-management/SKILL.md +120 -0
  100. package/departments/ops/skills/soc2-compliance/SKILL.md +120 -0
  101. package/departments/strategy/skills/cto-advisor/SKILL.md +4 -0
  102. package/departments/strategy/skills/cto-advisor/references/build-vs-buy-framework.md +190 -0
  103. package/installer/cli.js +13 -2
  104. package/installer/index.js +1 -2
  105. package/installer/migrate.js +123 -0
  106. package/installer/update.js +28 -15
  107. package/package.json +1 -1
  108. package/pyproject.toml +1 -1
  109. package/core/agents/__pycache__/registry_gen.cpython-313.pyc +0 -0
@@ -0,0 +1,172 @@
1
+ # Compliance Framework Comparison — Deep Reference
2
+
3
+ > Companion to `ciso-advisor/SKILL.md`. Framework details, timelines, costs, control overlap, and audit preparation.
4
+
5
+ ## Framework Overview
6
+
7
+ | Framework | Scope | Mandatory? | Target Market | Certifiable? |
8
+ |-----------|-------|-----------|---------------|-------------|
9
+ | SOC 2 Type I | Security controls at a point in time | No (market-driven) | US B2B SaaS | Yes (audit report) |
10
+ | SOC 2 Type II | Controls operating over 3-12 months | No (market-driven) | US B2B SaaS, Enterprise | Yes (audit report) |
11
+ | ISO 27001 | Information security management system | No (market-driven) | Global, enterprise | Yes (certification) |
12
+ | GDPR | Personal data protection (EU residents) | Yes (law) | Any company handling EU data | No (compliance, not cert) |
13
+ | HIPAA | Protected health information (PHI) | Yes (law, US healthcare) | Healthcare, health tech | No (compliance, not cert) |
14
+ | PCI-DSS v4.0 | Cardholder data environment | Yes (contractual) | Any company processing cards | Yes (assessment) |
15
+
16
+ ## Timeline and Cost Estimates
17
+
18
+ | Framework | Prep Time | Audit/Assessment | Total Timeline | Cost Range (startup) | Cost Range (mid-market) |
19
+ |-----------|-----------|-----------------|---------------|---------------------|------------------------|
20
+ | SOC 2 Type I | 2-4 months | 1-2 months | 3-6 months | $30K-$80K | $50K-$150K |
21
+ | SOC 2 Type II | 6-9 months (incl. observation) | 3-6 month observation | 9-15 months | $50K-$120K | $80K-$250K |
22
+ | ISO 27001 | 6-12 months | 2-3 months (Stage 1+2) | 8-15 months | $40K-$100K | $80K-$200K |
23
+ | GDPR | 3-6 months (initial) | Ongoing | Continuous | $20K-$60K | $50K-$200K |
24
+ | HIPAA | 6-12 months | Ongoing (annual review) | Continuous | $40K-$100K | $100K-$300K |
25
+ | PCI-DSS | 3-12 months | Quarterly scans + annual SAQ/ROC | Continuous | $20K-$80K (SAQ) | $100K-$500K (ROC) |
26
+
27
+ **Cost includes:** GRC platform, auditor fees, consultant fees, remediation. **Does not include:** FTE time, infrastructure changes.
28
+
29
+ ## Recommended Sequencing
30
+
31
+ ```
32
+ Phase 0: Security Hygiene (Month 1-2)
33
+ - MFA on all accounts
34
+ - Endpoint protection
35
+ - Automated patching
36
+ - Encrypted backups
37
+ - Access reviews
38
+
39
+ Phase 1: SOC 2 Type I (Month 3-6)
40
+ - Unlocks: Enterprise sales conversations
41
+ - Effort: Medium
42
+ - ROI: Fastest path to "we're audited"
43
+
44
+ Phase 2: SOC 2 Type II (Month 6-12)
45
+ - Unlocks: Enterprise deal closures, security questionnaire answers
46
+ - Effort: Medium (observation period)
47
+ - ROI: Most requested by US enterprise buyers
48
+
49
+ Phase 3: ISO 27001 (Month 12-18)
50
+ - Unlocks: Global enterprise, government contracts
51
+ - Effort: High (ISMS establishment)
52
+ - ROI: International recognition, 3-year certification
53
+
54
+ Phase 4: Domain-Specific (Month 18+)
55
+ - HIPAA if healthcare
56
+ - PCI-DSS if processing cards directly
57
+ - GDPR (should start in Phase 0 if handling EU data)
58
+ ```
59
+
60
+ ## Control Overlap Matrix
61
+
62
+ Implementing one framework gives you progress toward others. Overlap percentage of controls:
63
+
64
+ | Control Domain | SOC 2 | ISO 27001 | GDPR | HIPAA | PCI-DSS |
65
+ |---------------|:-----:|:---------:|:----:|:-----:|:-------:|
66
+ | Access control | X | X | X | X | X |
67
+ | Encryption (at rest) | X | X | X | X | X |
68
+ | Encryption (in transit) | X | X | X | X | X |
69
+ | Logging and monitoring | X | X | | X | X |
70
+ | Incident response | X | X | X | X | X |
71
+ | Vendor management | X | X | X | X | X |
72
+ | Change management | X | X | | | X |
73
+ | Business continuity | X | X | | X | |
74
+ | Data classification | | X | X | X | X |
75
+ | Data retention/deletion | | X | X | X | |
76
+ | Privacy impact assessment | | | X | X | |
77
+ | Breach notification | | | X | X | X |
78
+ | Physical security | X | X | | X | X |
79
+ | HR security (background checks) | X | X | | X | X |
80
+ | Risk assessment | X | X | X | X | X |
81
+ | Security awareness training | X | X | X | X | X |
82
+
83
+ **Key insight:** SOC 2 Type II gives ~60% overlap with ISO 27001 controls. Start with SOC 2, then extend to ISO.
84
+
85
+ ## SOC 2 Trust Service Criteria
86
+
87
+ | Criteria | Required? | Key Controls |
88
+ |----------|-----------|-------------|
89
+ | Security (Common Criteria) | Always required | Access control, firewalls, encryption, monitoring |
90
+ | Availability | If uptime SLA matters | Redundancy, DR plan, capacity planning |
91
+ | Processing Integrity | If data accuracy matters | Input validation, error handling, reconciliation |
92
+ | Confidentiality | If handling confidential data | Classification, DLP, encryption, access restrictions |
93
+ | Privacy | If handling PII | Consent, data minimization, retention, subject rights |
94
+
95
+ **Typical first audit:** Security + Availability (most buyer requests).
96
+
97
+ ## Audit Preparation Checklist
98
+
99
+ ### 90 Days Before Audit
100
+
101
+ - [ ] GRC platform populated with all controls and evidence
102
+ - [ ] All policies reviewed and approved within last 12 months
103
+ - [ ] Access reviews completed for all critical systems
104
+ - [ ] Vulnerability scans current (no critical/high unresolved > 30 days)
105
+ - [ ] Penetration test completed within last 12 months
106
+ - [ ] Incident response plan tested (tabletop exercise documented)
107
+ - [ ] Vendor risk assessments current for Tier 1 vendors
108
+ - [ ] Security awareness training completed by all employees
109
+ - [ ] Business continuity/DR plan tested within last 12 months
110
+ - [ ] Change management logs complete and consistent
111
+
112
+ ### 30 Days Before Audit
113
+
114
+ - [ ] Evidence collection automated where possible (API pulls from tools)
115
+ - [ ] Gap analysis completed -- no open critical gaps
116
+ - [ ] Point of contact assigned for each control domain
117
+ - [ ] Auditor provided with system description and scope
118
+ - [ ] Walkthrough scheduled with auditor for complex controls
119
+ - [ ] Exception log documented (any deviations with compensating controls)
120
+
121
+ ### During Audit
122
+
123
+ - [ ] Respond to auditor requests within 24 hours
124
+ - [ ] Provide evidence in organized, labeled format
125
+ - [ ] Escalate blockers to compliance lead immediately
126
+ - [ ] Track all auditor questions and status in shared document
127
+
128
+ ## Policy Document Inventory
129
+
130
+ | Policy | SOC 2 | ISO 27001 | GDPR | HIPAA | PCI-DSS |
131
+ |--------|:-----:|:---------:|:----:|:-----:|:-------:|
132
+ | Information Security Policy | R | R | R | R | R |
133
+ | Acceptable Use Policy | R | R | | R | R |
134
+ | Access Control Policy | R | R | R | R | R |
135
+ | Data Classification Policy | | R | R | R | R |
136
+ | Data Retention Policy | | R | R | R | R |
137
+ | Incident Response Plan | R | R | R | R | R |
138
+ | Business Continuity Plan | R | R | | R | |
139
+ | Vendor Management Policy | R | R | R | R | R |
140
+ | Change Management Policy | R | R | | | R |
141
+ | Encryption Policy | R | R | R | R | R |
142
+ | Privacy Policy (external) | | | R | R | |
143
+ | Password Policy | R | R | | R | R |
144
+ | Physical Security Policy | R | R | | R | R |
145
+ | Risk Management Policy | R | R | R | R | R |
146
+ | SDLC/Secure Development Policy | R | R | | | R |
147
+
148
+ **R = Required.** Writing once with framework-agnostic language covers multiple audits.
149
+
150
+ ## GRC Platform Selection
151
+
152
+ | Platform | Best For | Price Range | Key Feature |
153
+ |----------|----------|-------------|------------|
154
+ | Vanta | Startups, fast SOC 2 | $10K-$50K/yr | Automated evidence collection |
155
+ | Drata | Mid-market, multi-framework | $10K-$50K/yr | Custom controls, integrations |
156
+ | Secureframe | Startups, simple setup | $8K-$40K/yr | Fast onboarding |
157
+ | Tugboat Logic (OneTrust) | Mid-market | $15K-$60K/yr | Risk management focus |
158
+ | OneTrust | Enterprise, privacy-heavy | $50K-$200K/yr | GDPR/privacy specialization |
159
+ | Manual (spreadsheets) | <10 employees, one framework | $0 | Pain |
160
+
161
+ **Decision rule:** If pursuing SOC 2 and have > 15 employees, a GRC platform pays for itself in audit prep time saved.
162
+
163
+ ## Common Compliance Mistakes
164
+
165
+ | Mistake | Consequence | Fix |
166
+ |---------|------------|-----|
167
+ | Starting with ISO 27001 before SOC 2 | Longer time to first audit report | SOC 2 Type I first (3-6 months) |
168
+ | Policies written but not followed | Audit findings, qualified report | Automate enforcement where possible |
169
+ | Annual access reviews only | Stale access, audit gaps | Quarterly for privileged, semi-annual for standard |
170
+ | No evidence of control operation | Auditor cannot verify | Automated evidence collection via GRC platform |
171
+ | Treating compliance as one-time project | Controls degrade, next audit fails | Continuous monitoring, monthly reviews |
172
+ | Scope too broad on first audit | Higher cost, more findings | Start narrow, expand in subsequent years |
@@ -121,3 +121,7 @@ Surface these issues WITHOUT being asked:
121
121
  ### Monitoring Plan
122
122
  | Metric | Tool | Threshold | Review Cadence |
123
123
  ```
124
+
125
+ ## References
126
+
127
+ - [template-playbooks.md](references/template-playbooks.md) — 12 programmatic SEO playbooks with URL structures, schema markup, internal linking strategies, and indexation rules per page type
@@ -0,0 +1,289 @@
1
+ # Programmatic SEO Template Playbooks — Deep Reference
2
+
3
+ > Companion to `programmatic-seo/SKILL.md`. 12 playbooks with URL structures, schema markup, and internal linking strategies.
4
+
5
+ ## Playbook Index
6
+
7
+ | # | Playbook | Keyword Pattern | Pages Potential | Difficulty |
8
+ |---|----------|----------------|:---------------:|:----------:|
9
+ | 1 | Location Pages | `[service] in [city]` | 100-10K | Low |
10
+ | 2 | Comparison Pages | `[X] vs [Y]` | 50-500 | Medium |
11
+ | 3 | Alternative Pages | `[product] alternatives` | 20-200 | Medium |
12
+ | 4 | Tool/Calculator Pages | `[type] calculator` | 10-100 | Low |
13
+ | 5 | Glossary Pages | `what is [term]` | 100-1K | Low |
14
+ | 6 | Statistics Pages | `[industry] statistics` | 20-200 | Medium |
15
+ | 7 | Template Pages | `[type] template` | 50-500 | Low |
16
+ | 8 | Directory Pages | `best [category] tools` | 20-200 | High |
17
+ | 9 | Integration Pages | `[A] + [B] integration` | 50-500 | Low |
18
+ | 10 | Persona Pages | `[product] for [audience]` | 20-200 | Medium |
19
+ | 11 | Examples/Gallery Pages | `[type] examples` | 50-500 | Low |
20
+ | 12 | Profile Pages | `[entity] [attribute]` | 100-10K | Medium |
21
+
22
+ ---
23
+
24
+ ## 1. Location Pages
25
+
26
+ **Pattern:** `[service] in [city/state/country]`
27
+ **Example:** "dentists in austin", "coworking spaces in lisbon"
28
+
29
+ | Element | Specification |
30
+ |---------|--------------|
31
+ | URL | `/[service]/[city-slug]/` |
32
+ | Title | `Best [Service] in [City] - [Year] Guide \| [Brand]` |
33
+ | H1 | `[Service] in [City]` |
34
+ | Unique content | Local data, pricing, reviews, neighborhood info |
35
+ | Schema | `LocalBusiness`, `Service`, `AggregateRating` |
36
+ | Internal links | Parent city hub, nearby cities, related services |
37
+
38
+ **Data sources:** Google Business API, Yelp, government records, own data.
39
+ **Thin content risk:** High. Must add unique local insights per page, not just city name swaps.
40
+
41
+ ## 2. Comparison Pages
42
+
43
+ **Pattern:** `[X] vs [Y]`
44
+ **Example:** "webflow vs wordpress", "notion vs confluence"
45
+
46
+ | Element | Specification |
47
+ |---------|--------------|
48
+ | URL | `/compare/[x]-vs-[y]/` |
49
+ | Title | `[X] vs [Y]: Honest Comparison ([Year]) \| [Brand]` |
50
+ | H1 | `[X] vs [Y]` |
51
+ | Unique content | Feature matrix, pricing table, use case recommendations |
52
+ | Schema | `FAQPage`, `Table` |
53
+ | Internal links | Individual product pages, related comparisons, category hub |
54
+
55
+ **Content structure:**
56
+ 1. Quick verdict (above fold)
57
+ 2. Side-by-side feature comparison table
58
+ 3. Pricing comparison
59
+ 4. Best for [use case A] vs best for [use case B]
60
+ 5. FAQ section
61
+
62
+ **Linking strategy:** Create a comparison hub (`/compare/`) linking all pairs. Link bidirectionally: X-vs-Y and Y-vs-X redirect to canonical.
63
+
64
+ ## 3. Alternative Pages
65
+
66
+ **Pattern:** `[product] alternatives`
67
+ **Example:** "mailchimp alternatives", "figma alternatives"
68
+
69
+ | Element | Specification |
70
+ |---------|--------------|
71
+ | URL | `/alternatives/[product-slug]/` |
72
+ | Title | `Top [N] [Product] Alternatives ([Year]) \| [Brand]` |
73
+ | H1 | `Best [Product] Alternatives` |
74
+ | Unique content | Why switch, ranked alternatives with pros/cons, migration tips |
75
+ | Schema | `ItemList`, `FAQPage` |
76
+ | Internal links | Comparison pages for each alternative pair, product reviews |
77
+
78
+ **Ranking criteria to include:** Price, feature overlap, migration difficulty, best for [use case].
79
+
80
+ ## 4. Tool/Calculator Pages
81
+
82
+ **Pattern:** `[type] calculator`, `[unit] converter`
83
+ **Example:** "mortgage calculator", "px to rem converter"
84
+
85
+ | Element | Specification |
86
+ |---------|--------------|
87
+ | URL | `/tools/[tool-slug]/` |
88
+ | Title | `Free [Type] Calculator \| [Brand]` |
89
+ | H1 | `[Type] Calculator` |
90
+ | Unique content | Interactive tool, formula explanation, related examples |
91
+ | Schema | `WebApplication`, `FAQPage` |
92
+ | Internal links | Related tools, glossary terms, guides using this calculation |
93
+
94
+ **Key success factors:** Tool must work without JavaScript for basic Googlebot rendering. Include text content below the tool for crawlability.
95
+
96
+ ## 5. Glossary Pages
97
+
98
+ **Pattern:** `what is [term]`, `[term] definition`
99
+ **Example:** "what is pSEO", "what is ARR"
100
+
101
+ | Element | Specification |
102
+ |---------|--------------|
103
+ | URL | `/glossary/[term-slug]/` |
104
+ | Title | `What is [Term]? Definition & Examples \| [Brand]` |
105
+ | H1 | `What is [Term]?` |
106
+ | Unique content | Clear definition, examples, related terms, visual aids |
107
+ | Schema | `DefinedTerm`, `FAQPage` |
108
+ | Internal links | Related glossary terms, in-depth guides, parent topic hub |
109
+
110
+ **Content template:**
111
+ 1. One-sentence definition (target featured snippet)
112
+ 2. Expanded explanation (2-3 paragraphs)
113
+ 3. Real-world examples
114
+ 4. Common misconceptions
115
+ 5. Related terms (linked)
116
+
117
+ ## 6. Statistics Pages
118
+
119
+ **Pattern:** `[industry/topic] statistics [year]`
120
+ **Example:** "saas churn statistics 2025", "remote work statistics"
121
+
122
+ | Element | Specification |
123
+ |---------|--------------|
124
+ | URL | `/statistics/[topic-slug]/` |
125
+ | Title | `[N]+ [Topic] Statistics ([Year]) \| [Brand]` |
126
+ | H1 | `[Topic] Statistics for [Year]` |
127
+ | Unique content | Curated statistics with sources, charts, trend analysis |
128
+ | Schema | `Article`, `Dataset` |
129
+ | Internal links | Related statistics pages, guides citing these stats, glossary |
130
+
131
+ **Defensibility:** High if you aggregate and visualize. Update annually for evergreen traffic. Always cite primary sources.
132
+
133
+ ## 7. Template Pages
134
+
135
+ **Pattern:** `[type] template`, `[type] example`
136
+ **Example:** "business plan template", "invoice template"
137
+
138
+ | Element | Specification |
139
+ |---------|--------------|
140
+ | URL | `/templates/[type-slug]/` |
141
+ | Title | `Free [Type] Template ([Year]) - Download Now \| [Brand]` |
142
+ | H1 | `[Type] Template` |
143
+ | Unique content | Preview, download, customization guide, use cases |
144
+ | Schema | `CreativeWork`, `HowTo` |
145
+ | Internal links | Related templates, guides on the topic, tool pages |
146
+
147
+ **Conversion strategy:** Free preview, email gate for download, premium templates for paid users.
148
+
149
+ ## 8. Directory/Listicle Pages
150
+
151
+ **Pattern:** `best [category] tools`, `top [N] [category]`
152
+ **Example:** "best project management tools", "top 10 CRM software"
153
+
154
+ | Element | Specification |
155
+ |---------|--------------|
156
+ | URL | `/best/[category-slug]/` |
157
+ | Title | `[N] Best [Category] Tools ([Year]) \| [Brand]` |
158
+ | H1 | `Best [Category] Tools` |
159
+ | Unique content | Ranked list with scoring criteria, screenshots, pricing |
160
+ | Schema | `ItemList`, `Review`, `FAQPage` |
161
+ | Internal links | Individual reviews, comparison pages, alternative pages |
162
+
163
+ **Scoring framework:** Define clear criteria (features, pricing, ease of use, support). Show scores transparently.
164
+
165
+ ## 9. Integration Pages
166
+
167
+ **Pattern:** `[A] + [B] integration`, `connect [A] to [B]`
168
+ **Example:** "slack asana integration", "zapier hubspot"
169
+
170
+ | Element | Specification |
171
+ |---------|--------------|
172
+ | URL | `/integrations/[a-slug]-[b-slug]/` |
173
+ | Title | `[A] + [B] Integration: How to Connect \| [Brand]` |
174
+ | H1 | `Connect [A] to [B]` |
175
+ | Unique content | Setup steps, use cases, limitations, alternatives |
176
+ | Schema | `HowTo`, `SoftwareApplication` |
177
+ | Internal links | Both product pages, related integrations, comparison pages |
178
+
179
+ **Scale strategy:** If you have N integrations, you can generate N*(N-1)/2 combination pages. Only create pages with verified search volume.
180
+
181
+ ## 10. Persona Pages
182
+
183
+ **Pattern:** `[product] for [audience]`
184
+ **Example:** "crm for real estate", "accounting software for freelancers"
185
+
186
+ | Element | Specification |
187
+ |---------|--------------|
188
+ | URL | `/for/[audience-slug]/` |
189
+ | Title | `[Product] for [Audience]: Features & Pricing \| [Brand]` |
190
+ | H1 | `[Product] for [Audience]` |
191
+ | Unique content | Audience-specific features, testimonials, use cases, pricing |
192
+ | Schema | `Product`, `FAQPage` |
193
+ | Internal links | Main product page, related persona pages, case studies |
194
+
195
+ **Content differentiation:** Each persona page must highlight different features, different testimonials, and different use cases. Not just audience name swaps.
196
+
197
+ ## 11. Examples/Gallery Pages
198
+
199
+ **Pattern:** `[type] examples`, `[type] inspiration`
200
+ **Example:** "landing page examples", "portfolio website examples"
201
+
202
+ | Element | Specification |
203
+ |---------|--------------|
204
+ | URL | `/examples/[type-slug]/` |
205
+ | Title | `[N] [Type] Examples for Inspiration ([Year]) \| [Brand]` |
206
+ | H1 | `[Type] Examples` |
207
+ | Unique content | Curated examples with screenshots, analysis, what works and why |
208
+ | Schema | `ItemList`, `ImageObject` |
209
+ | Internal links | Template pages, related examples, how-to guides |
210
+
211
+ **Image optimization:** Compress screenshots, use descriptive alt text, implement lazy loading. Images are the content here.
212
+
213
+ ## 12. Profile/Entity Pages
214
+
215
+ **Pattern:** `[entity name] [attribute]`
216
+ **Example:** "stripe ceo", "shopify revenue", "notion pricing"
217
+
218
+ | Element | Specification |
219
+ |---------|--------------|
220
+ | URL | `/companies/[entity-slug]/` or `/people/[entity-slug]/` |
221
+ | Title | `[Entity]: [Key Attribute] & Overview \| [Brand]` |
222
+ | H1 | `[Entity]` |
223
+ | Unique content | Structured data about the entity, timeline, key facts |
224
+ | Schema | `Organization`, `Person`, `Article` |
225
+ | Internal links | Related entities, industry pages, comparison pages |
226
+
227
+ **Data defensibility:** Strongest when using proprietary data. Public data pages compete with Wikipedia and Crunchbase.
228
+
229
+ ---
230
+
231
+ ## Universal Internal Linking Strategy
232
+
233
+ ### Hub-and-Spoke Model
234
+
235
+ ```
236
+ [Category Hub]
237
+ / | | \
238
+ [Page A] [Page B] [Page C] [Page D]
239
+ | | | |
240
+ [Sub A1] [Sub B1] [Sub C1] [Sub D1]
241
+ ```
242
+
243
+ ### Cross-Linking Rules
244
+
245
+ | Rule | Implementation |
246
+ |------|---------------|
247
+ | Every page links to its parent hub | Breadcrumb + in-content link |
248
+ | Hub links to all children | Paginated list or directory |
249
+ | Siblings link to each other | "Related" section (3-5 links) |
250
+ | Cross-type linking | Glossary term links to comparison, comparison links to alternatives |
251
+ | No orphan pages | Every page reachable within 3 clicks from homepage |
252
+
253
+ ## Universal Schema Markup Checklist
254
+
255
+ - [ ] `BreadcrumbList` on every page (navigation path)
256
+ - [ ] Primary schema type matching page intent (see per-playbook above)
257
+ - [ ] `FAQPage` where genuine questions are answered
258
+ - [ ] `Organization` on the homepage
259
+ - [ ] `SiteNavigationElement` in header/footer
260
+ - [ ] Test with Google Rich Results Test before launch
261
+ - [ ] Monitor Search Console for schema errors weekly
262
+
263
+ ## Indexation Strategy for Scale
264
+
265
+ | Page Count | Strategy |
266
+ |------------|---------|
267
+ | < 100 pages | Index all, single sitemap |
268
+ | 100-1K pages | Index all with quality threshold, segmented sitemaps |
269
+ | 1K-10K pages | noindex thin pages (<300 words), priority in sitemap |
270
+ | 10K+ pages | Aggressive quality gating, separate sitemap per type, crawl budget management |
271
+
272
+ ### Sitemap Segmentation
273
+
274
+ ```xml
275
+ sitemap-index.xml
276
+ sitemap-locations.xml (location pages)
277
+ sitemap-comparisons.xml (comparison pages)
278
+ sitemap-glossary.xml (glossary pages)
279
+ sitemap-tools.xml (tool/calculator pages)
280
+ ```
281
+
282
+ ### Quality Gate Before Indexing
283
+
284
+ | Check | Threshold | Action if Below |
285
+ |-------|-----------|----------------|
286
+ | Word count | > 300 words | noindex or add content |
287
+ | Unique content ratio | > 60% unique vs template | noindex or rewrite |
288
+ | Search volume for target keyword | > 10/month | noindex or consolidate |
289
+ | Internal links pointing to page | >= 2 | Add links or orphan alert |
@@ -0,0 +1,104 @@
1
+ ---
2
+ name: ops/gdpr-compliance
3
+ description: >
4
+ GDPR compliance assessment with data mapping, DPIA generation, breach response planning, and data subject rights management.
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # GDPR Compliance — `/ops gdpr-compliance`
9
+
10
+ > **Agent:** Daniel (Ops Lead) | **Framework:** GDPR (EU 2016/679), Privacy by Design (Cavoukian)
11
+
12
+ ## GDPR Compliance Checklist
13
+
14
+ | Area | Requirement | GDPR Article | Status |
15
+ |------|------------|-------------|--------|
16
+ | Legal Basis | Documented lawful basis for each processing activity | Art. 6 | [ ] |
17
+ | Consent | Freely given, specific, informed, unambiguous | Art. 7 | [ ] |
18
+ | Data Mapping | Records of processing activities maintained | Art. 30 | [ ] |
19
+ | DPIA | Impact assessment for high-risk processing | Art. 35 | [ ] |
20
+ | DPO | Data Protection Officer appointed (if required) | Art. 37 | [ ] |
21
+ | Subject Rights | Process for access, rectification, erasure, portability | Art. 15-20 | [ ] |
22
+ | Breach Response | 72-hour notification procedure documented | Art. 33 | [ ] |
23
+ | Transfers | Adequate safeguards for international data transfers | Art. 46 | [ ] |
24
+ | Privacy by Design | Data protection integrated into system design | Art. 25 | [ ] |
25
+ | Retention | Data retention and deletion policies defined | Art. 5(1)(e) | [ ] |
26
+
27
+ ## Data Mapping Template
28
+
29
+ | Processing Activity | Data Categories | Data Subjects | Legal Basis | Retention | Recipients | Transfers |
30
+ |---------------------|----------------|---------------|-------------|-----------|------------|-----------|
31
+ | User registration | Name, email | Customers | Contract | Account lifetime + 1yr | Internal | None |
32
+ | Newsletter | Email, preferences | Subscribers | Consent | Until withdrawal | Mailchimp | US (SCCs) |
33
+ | Analytics | IP, behavior | Visitors | Legitimate interest | 26 months | Google | US (SCCs) |
34
+
35
+ ## DPIA Decision Criteria
36
+
37
+ A DPIA is **required** when processing involves:
38
+
39
+ | Criterion | Example | WP29 Reference |
40
+ |-----------|---------|----------------|
41
+ | Systematic monitoring | Employee tracking, CCTV | Art. 35(3)(c) |
42
+ | Large-scale special data | Health records platform | Art. 35(3)(b) |
43
+ | Automated decisions with legal effects | Credit scoring, hiring AI | Art. 35(3)(a) |
44
+ | Combining datasets | CRM + analytics merge | WP248 criterion 4 |
45
+ | Vulnerable data subjects | Children, employees | WP248 criterion 7 |
46
+ | New technology | Biometrics, AI profiling | WP248 criterion 8 |
47
+
48
+ ## Data Subject Rights — Response Workflow
49
+
50
+ | Right | Article | Deadline | Extensions |
51
+ |-------|---------|----------|------------|
52
+ | Access | Art. 15 | 30 days | +60 days (complex) |
53
+ | Rectification | Art. 16 | 30 days | +60 days (complex) |
54
+ | Erasure ("Right to be Forgotten") | Art. 17 | 30 days | +60 days (complex) |
55
+ | Restriction | Art. 18 | 30 days | +60 days (complex) |
56
+ | Portability | Art. 20 | 30 days | +60 days (complex) |
57
+ | Objection | Art. 21 | 30 days | N/A |
58
+
59
+ ## Breach Response Procedure
60
+
61
+ 1. **Detect and contain** — Isolate affected systems, preserve evidence
62
+ 2. **Assess severity** — Personal data types, number of subjects, likely harm
63
+ 3. **Notify authority** — Within 72 hours if risk to rights/freedoms (Art. 33)
64
+ 4. **Notify data subjects** — Without undue delay if high risk (Art. 34)
65
+ 5. **Document** — Record breach details, effects, remedial actions taken
66
+ 6. **Review** — Update risk assessment and preventive controls
67
+
68
+ ## Proactive Triggers
69
+
70
+ Surface these issues WITHOUT being asked:
71
+
72
+ - Personal data processing without DPIA documented -> flag as GDPR Art. 35 violation risk
73
+ - No DPO appointed when processing triggers mandatory designation -> flag as Art. 37 compliance gap
74
+ - Data retention policy missing or undefined for processing activities -> flag as Art. 5(1)(e) breach risk
75
+
76
+ ## Output
77
+
78
+ ```markdown
79
+ ## GDPR Compliance Assessment: <organization/project>
80
+
81
+ ### Compliance Score: X/10
82
+
83
+ ### Critical Gaps
84
+ - [CG1] Description — Art. X reference — Remediation steps
85
+
86
+ ### Data Mapping Summary
87
+ - Processing activities documented: X
88
+ - Legal bases verified: X/X
89
+ - International transfers: X (safeguards: Y/N)
90
+
91
+ ### DPIA Status
92
+ - Required: Y/N — Reason: [criteria]
93
+ - Completed: Y/N
94
+
95
+ ### Recommendations
96
+ 1. [Priority] Action — Timeline — Owner
97
+
98
+ ### Next Review: <date>
99
+ ```
100
+
101
+ ## References
102
+
103
+ - [gdpr-compliance-guide.md](references/gdpr-compliance-guide.md) — Legal bases, special category data, accountability requirements, breach notification procedures
104
+ - [dpia-methodology.md](references/dpia-methodology.md) — DPIA threshold assessment, risk methodology, mitigation categories, consultation process
@@ -0,0 +1,113 @@
1
+ ---
2
+ name: ops/iso27001
3
+ description: >
4
+ ISO 27001 ISMS implementation, control mapping, risk treatment planning, and certification audit preparation.
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # ISO 27001 ISMS — `/ops iso27001`
9
+
10
+ > **Agent:** Daniel (Ops Lead) | **Framework:** ISO 27001:2022, ISO 27002:2022, ISMS
11
+
12
+ ## ISMS Implementation Phases
13
+
14
+ | Phase | Key Activities | Deliverables | Timeline |
15
+ |-------|---------------|-------------|----------|
16
+ | 1. Context | Define scope, interested parties, internal/external issues | Scope statement, context document | 2-4 weeks |
17
+ | 2. Leadership | Security policy, roles, management commitment | IS policy, RACI chart | 1-2 weeks |
18
+ | 3. Planning | Risk assessment, risk treatment, objectives | Risk register, treatment plan, SoA | 4-6 weeks |
19
+ | 4. Support | Resources, competence, awareness, communication | Training plan, comm matrix | 2-4 weeks |
20
+ | 5. Operation | Implement controls, operate processes | Control evidence, procedures | 8-12 weeks |
21
+ | 6. Evaluation | Internal audit, management review, monitoring | Audit report, review minutes | 2-4 weeks |
22
+ | 7. Improvement | Nonconformity management, continual improvement | CAPA records, improvement log | Ongoing |
23
+
24
+ ## Risk Assessment Methodology
25
+
26
+ | Step | Activity | Output |
27
+ |------|----------|--------|
28
+ | 1 | Identify information assets and owners | Asset inventory |
29
+ | 2 | Identify threats per asset | Threat catalog |
30
+ | 3 | Identify vulnerabilities exploitable by threats | Vulnerability list |
31
+ | 4 | Assess likelihood (1-5) and impact (1-5) | Risk scores |
32
+ | 5 | Calculate risk level (L x I) | Risk matrix |
33
+ | 6 | Determine treatment (mitigate, accept, transfer, avoid) | Risk treatment plan |
34
+
35
+ ### Risk Matrix
36
+
37
+ | Likelihood / Impact | Negligible (1) | Minor (2) | Moderate (3) | Major (4) | Critical (5) |
38
+ |---------------------|---------------|-----------|-------------|-----------|-------------|
39
+ | Almost Certain (5) | 5 | 10 | 15 | 20 | 25 |
40
+ | Likely (4) | 4 | 8 | 12 | 16 | 20 |
41
+ | Possible (3) | 3 | 6 | 9 | 12 | 15 |
42
+ | Unlikely (2) | 2 | 4 | 6 | 8 | 10 |
43
+ | Rare (1) | 1 | 2 | 3 | 4 | 5 |
44
+
45
+ **Treatment thresholds:** 1-4 Accept | 5-9 Monitor | 10-15 Mitigate (90 days) | 16-20 Mitigate (30 days) | 21-25 Immediate action
46
+
47
+ ## Annex A Control Categories (ISO 27002:2022)
48
+
49
+ | Category | Controls | Examples |
50
+ |----------|---------|---------|
51
+ | Organizational (5-8) | 37 | Policies, roles, asset management, access control |
52
+ | People (6) | 8 | Screening, awareness, disciplinary, termination |
53
+ | Physical (7) | 14 | Perimeters, entry controls, equipment security |
54
+ | Technological (8) | 34 | Endpoint, privileged access, encryption, logging |
55
+
56
+ ## Certification Readiness Checklist
57
+
58
+ ### Stage 1 (Documentation Review)
59
+ - [ ] ISMS scope documented and approved
60
+ - [ ] Information security policy signed by management
61
+ - [ ] Risk assessment methodology defined and executed
62
+ - [ ] Statement of Applicability (SoA) completed
63
+ - [ ] Risk treatment plan with control mapping
64
+ - [ ] Internal audit conducted within past 12 months
65
+ - [ ] Management review completed with documented outputs
66
+
67
+ ### Stage 2 (Implementation Audit)
68
+ - [ ] All Stage 1 findings resolved
69
+ - [ ] ISMS operational for minimum 3 months
70
+ - [ ] Controls implemented with evidence of effectiveness
71
+ - [ ] Security awareness training completed organization-wide
72
+ - [ ] Incident response plan tested
73
+ - [ ] Access reviews documented at required frequency
74
+ - [ ] Metrics collected and monitored
75
+
76
+ ## Proactive Triggers
77
+
78
+ Surface these issues WITHOUT being asked:
79
+
80
+ - ISMS scope undefined or not formally approved -> flag as Clause 4.3 gap blocking certification
81
+ - No risk treatment plan linking risks to Annex A controls -> flag as Clause 6.1.3 nonconformity
82
+ - Annex A controls not mapped in Statement of Applicability -> flag as Clause 6.1.3(d) requirement
83
+
84
+ ## Output
85
+
86
+ ```markdown
87
+ ## ISO 27001 Assessment: <organization>
88
+
89
+ ### ISMS Maturity: <Initial | Managed | Defined | Measured | Optimizing>
90
+
91
+ ### Gap Analysis Summary
92
+ - Clauses assessed: X/10
93
+ - Controls mapped: X/93 (Annex A)
94
+ - Gaps identified: X critical, X high, X medium
95
+
96
+ ### Risk Register Summary
97
+ - Total risks: X
98
+ - Critical/High: X (treatment plans required)
99
+ - Accepted: X (with documented rationale)
100
+
101
+ ### Certification Readiness: X% (Stage 1) / X% (Stage 2)
102
+
103
+ ### Remediation Roadmap
104
+ | Priority | Gap | Action | Owner | Target |
105
+ |----------|-----|--------|-------|--------|
106
+
107
+ ### Next Review: <date>
108
+ ```
109
+
110
+ ## References
111
+
112
+ - [iso27001-controls.md](references/iso27001-controls.md) — Full Annex A control list with implementation guidance and evidence requirements
113
+ - [risk-assessment-guide.md](references/risk-assessment-guide.md) — Risk methodology, asset classification, threat modeling, risk calculation methods