telo3-ai 5.0.7 → 6.1.0

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 (46) hide show
  1. package/README.md +35 -787
  2. package/SKILL.md +36 -657
  3. package/bootstrap/TELO3.md +17 -0
  4. package/cli.js +221 -42
  5. package/hooks/inject-contract.mjs +23 -0
  6. package/hooks/session-start.example.json +15 -0
  7. package/index.js +48 -14
  8. package/package.json +30 -69
  9. package/references/accessibility-quality.md +92 -272
  10. package/references/ai-behavior.md +70 -332
  11. package/references/anti-slop.md +71 -0
  12. package/references/document-specification.md +110 -419
  13. package/references/legal-compliance.md +90 -395
  14. package/references/performance-quality.md +100 -351
  15. package/references/privacy-compliance.md +88 -464
  16. package/references/project-audit.md +79 -440
  17. package/references/security-quality.md +68 -220
  18. package/references/seo-quality.md +83 -339
  19. package/references/smart-skill-delegation.md +73 -419
  20. package/references/token-optimization.md +83 -450
  21. package/references/ui-quality.md +106 -481
  22. package/references/workflow.md +91 -447
  23. package/src/activate.js +159 -0
  24. package/src/context.js +72 -0
  25. package/src/find-context.js +41 -0
  26. package/src/init.js +38 -0
  27. package/src/install.js +128 -0
  28. package/src/paths.js +20 -0
  29. package/src/status.js +30 -0
  30. package/src/tokens.js +10 -0
  31. package/src/validate.js +220 -0
  32. package/src/version.js +12 -0
  33. package/templates/architecture.md +17 -398
  34. package/templates/design.md +22 -631
  35. package/templates/memory.md +13 -351
  36. package/templates/prd.md +15 -295
  37. package/templates/rules.md +20 -600
  38. package/templates/tasks.md +10 -210
  39. package/AI-CONTEXT.md +0 -272
  40. package/ONBOARDING-SKILL.md +0 -738
  41. package/SKILL-METADATA.json +0 -237
  42. package/scripts/init-project-context.sh +0 -139
  43. package/scripts/validate-project-context.sh +0 -164
  44. package/skills/telo3/SKILL.md +0 -315
  45. package/skills/telo3-context/SKILL.md +0 -272
  46. package/skills/telo3-onboarding/SKILL.md +0 -738
@@ -1,378 +1,95 @@
1
1
  # Legal & Compliance Awareness
2
-
3
- > **IMPORTANT:** This is a decision-support and engineering tool, NOT legal advice. This system helps identify potentially applicable legal/compliance considerations but does NOT replace qualified legal counsel. Always verify current legal requirements with appropriate professionals before claiming compliance.
4
-
5
- ---
6
-
7
- ## Core Principles
8
-
9
- ### 1. Identify, Don't Invent
10
- - Identify potentially applicable laws and regulations
11
- - Do NOT invent legal requirements
12
- - Do NOT invent penalties or fines
13
- - Do NOT claim universal legal rules
14
-
15
- ### 2. Distinguish Types of Requirements
16
- - **Technical requirement:** Something that can be implemented in code
17
- - **Legal requirement:** Something required by law (varies by jurisdiction)
18
- - **Best practice:** Recommended but not legally required
19
- - **Assumption:** Needs verification
20
-
21
- ### 3. Verify Before Claiming
22
- - Do NOT claim "legally compliant" without proper verification
23
- - Do NOT hardcode penalties that change over time
24
- - Do NOT assume one jurisdiction's rules apply globally
25
- - Do NOT pretend regulations are simpler than they are
26
-
27
- ### 4. Recommend Legal Review
28
- When legal compliance matters:
29
- - Recommend consulting qualified legal counsel
30
- - Document what was implemented (technical)
31
- - Note what requires legal verification
32
- - Distinguish engineering from legal advice
33
-
34
- ---
35
-
36
- ## Legal Compliance Process
37
-
38
- ```
39
- 1. Identify Product Functionality
40
- └─> What does the product do?
41
-
42
- 2. Identify Potentially Regulated Features
43
- └─> Age gates, emails, subscriptions, user content, etc.
44
-
45
- 3. Identify Relevant Jurisdictions
46
- └─> Where are users located? Where is the business?
47
-
48
- 4. Research Applicable Requirements
49
- └─> What laws might apply? (COPPA, CAN-SPAM, etc.)
50
-
51
- 5. Distinguish Technical vs. Legal
52
- └─> What can code solve? What needs lawyer review?
53
-
54
- 6. Implement Technical Controls
55
- └─> Build required functionality
56
-
57
- 7. Document Compliance Responsibilities
58
- └─> What still needs legal/business verification?
59
-
60
- 8. Recommend Legal Review
61
- └─> Advise consulting qualified counsel
62
- ```
63
-
64
- ---
65
-
66
- ## Common Compliance Areas
67
-
68
- ### Age Restrictions & Children's Privacy
69
-
70
- #### When Applicable
71
- - Service can be used by children
72
- - Service collects personal information
73
- - Service has age-based restrictions
74
-
75
- #### U.S. Consideration: COPPA (Children's Online Privacy Protection Act)
76
- - **Applies when:** Service directed to children under 13, or actual knowledge of children under 13
77
- - **Key requirements (if applicable):**
78
- - Privacy policy
79
- - Parental notice
80
- - Parental consent for data collection
81
- - Parental access to child's information
82
- - Data security
83
- - Data retention/deletion
84
-
85
- #### Technical Controls to Consider
86
- - Age verification or age gate
87
- - Parental consent mechanism
88
- - Privacy policy
89
- - Data minimization for children
90
- - Deletion mechanism
91
-
92
- #### What to Document
93
- ```markdown
94
- ## Age Restrictions
95
-
96
- **Minimum age:** [e.g., 13, 16, 18, or "No restriction"]
97
- **Age verification:** [Implemented / Not required]
98
- **Parental consent:** [Implemented if required / Not applicable]
99
- **Children's data handling:** [Describe approach]
100
-
101
- **Legal review needed:** [Yes/No]
102
- ```
103
-
104
- #### Critical Notes
105
- - **Do NOT hardcode "$43,280 per violation"** or any specific fine
106
- - **Do NOT claim** COPPA requirements without verifying jurisdiction and applicability
107
- - **Do verify** current FTC guidance if COPPA may apply
108
- - **Do distinguish** between actual requirements and precautionary measures
109
-
110
- ---
111
-
112
- ### Marketing Emails
113
-
114
- #### When Applicable
115
- - Service sends promotional/marketing emails
116
- - Service sends commercial messages
117
-
118
- #### U.S. Consideration: CAN-SPAM Act
119
- - **Applies when:** Commercial messages sent to U.S. recipients
120
- - **Key requirements (if applicable):**
121
- - Clear sender identification
122
- - Accurate "From," "To," and routing information
123
- - Non-deceptive subject lines
124
- - Message identified as advertisement where required
125
- - Valid physical postal address
126
- - Clear opt-out mechanism
127
- - Honor opt-outs promptly (10 business days)
128
-
129
- #### Technical Controls to Consider
130
- - Unsubscribe link in emails
131
- - Unsubscribe processing system
132
- - Suppression list
133
- - Sender identification
134
- - Physical address in footer
135
- - Consent tracking
136
-
137
- #### What to Document
138
- ```markdown
139
- ## Marketing Emails
140
-
141
- **Email types:** [Transactional / Marketing / Both]
142
- **Unsubscribe mechanism:** [Implemented / Not applicable]
143
- **Sender identification:** [Configured]
144
- **Physical address:** [Required and included / Not applicable]
145
- **Consent mechanism:** [Describe]
146
-
147
- **Legal review needed:** [Yes/No]
148
- ```
149
-
150
- #### Critical Notes
151
- - **Do NOT hardcode "$46,517 per email"** or any specific penalty
152
- - **Do NOT assume** CAN-SPAM is the only applicable email law
153
- - **Do verify** whether GDPR, CASL (Canada), or other laws apply
154
- - **Do distinguish** transactional from marketing emails
155
-
156
- ---
157
-
158
- ### Subscriptions & Auto-Renewals
159
-
160
- #### When Applicable
161
- - Recurring billing
162
- - Subscription plans
163
- - Automatic renewals
164
- - Free trials that convert to paid
165
-
166
- #### U.S. State Laws (e.g., California automatic renewal laws)
167
- - Various U.S. states have automatic renewal disclosure requirements
168
- - Requirements vary by state
169
-
170
- #### Potential Requirements
171
- - Clear disclosure of subscription terms
172
- - Clear disclosure of automatic renewal
173
- - Clear cancellation method
174
- - Renewal reminders (in some jurisdictions)
175
- - Cancellation processing
176
-
177
- #### Technical Controls to Consider
178
- - Prominent display of:
179
- - Price
180
- - Billing frequency
181
- - Renewal terms
182
- - Trial duration and conversion
183
- - Cancellation method
184
- - Accessible cancellation mechanism
185
- - Renewal confirmation
186
- - Receipts
187
-
188
- #### What to Document
189
- ```markdown
190
- ## Subscriptions
191
-
192
- **Subscription types:** [List plans]
193
- **Auto-renewal:** [Yes/No]
194
- **Disclosure location:** [Where terms are shown]
195
- **Cancellation method:** [Describe]
196
- **Trial handling:** [Describe if applicable]
197
-
198
- **Legal review needed:** [Yes - specific jurisdictions]
199
- ```
200
-
201
- #### Critical Notes
202
- - **Do NOT assume** California law applies everywhere
203
- - **Do NOT hardcode** specific state requirements as universal
204
- - **Do verify** applicable state/country requirements
205
- - **Do ensure** material terms are clear at signup
206
-
207
- ---
208
-
209
- ### User-Generated Content & Copyright
210
-
211
- #### When Applicable
212
- - Users can upload files (images, videos, documents, code)
213
- - Users can post content
214
- - Platform hosts third-party content
215
-
216
- #### U.S. Consideration: DMCA Safe Harbor (17 U.S.C. § 512)
217
- - Provides liability protection for online service providers under specific conditions
218
-
219
- #### Potential Requirements for DMCA Safe Harbor
220
- - Designated DMCA agent
221
- - Agent registration with U.S. Copyright Office
222
- - Public availability of agent contact information
223
- - Notice-and-takedown process
224
- - Counter-notice process
225
- - Repeat infringer policy
226
- - No actual knowledge of infringement
227
- - No financial benefit from infringement
228
-
229
- #### Technical Controls to Consider
230
- - Copyright policy
231
- - DMCA agent designation
232
- - Takedown request form
233
- - Content flagging system
234
- - Repeat infringer tracking
235
- - User content licensing terms
236
-
237
- #### What to Document
238
- ```markdown
239
- ## User-Generated Content
240
-
241
- **Content types:** [Images, videos, text, etc.]
242
- **Copyright policy:** [Exists / Needed]
243
- **DMCA agent:** [Designated / Required / Not applicable]
244
- **Takedown process:** [Implemented / Planned]
245
- **Repeat infringer policy:** [Implemented / Planned]
246
-
247
- **Legal review needed:** [Yes]
248
- ```
249
-
250
- #### Critical Notes
251
- - **Do NOT claim** automatic safe harbor protection
252
- - **Do NOT hardcode** "$6 registration fee" (fees change)
253
- - **Do verify** current U.S. Copyright Office requirements
254
- - **Do NOT assume** DMCA applies outside the U.S.
255
- - **Do understand** safe harbor has specific technical and procedural requirements
256
-
257
- ---
2
+ **Load when:** building age gates, marketing emails, subscriptions/auto-renewals, user-generated content, or any feature touching personal data or regulated industries.
3
+
4
+ Engineering guidance and decision support, not legal advice. Identify potentially applicable laws; never replace qualified counsel. Laws vary by jurisdiction and change over time — verify current requirements before claiming compliance.
5
+
6
+ ## Core Rules
7
+
8
+ - Identify, don't invent: no invented legal requirements, no invented penalties/fines, no claimed universal legal rules.
9
+ - Classify every requirement: **technical** (implementable in code) / **legal** (required by law, jurisdiction-dependent) / **best practice** (recommended, not legally required) / **assumption** (needs verification).
10
+ - Never claim "legally compliant" without proper verification and evidence.
11
+ - Never hardcode penalties, fines, or fees as permanent facts (they change); verify current figures from authoritative sources (e.g., FTC, U.S. Copyright Office) when accuracy matters.
12
+ - Never assume one jurisdiction's rules apply globally; never pretend regulations are simpler than they are.
13
+ - Never pose as a lawyer or law firm, give legal advice, or make definitive legal conclusions.
14
+ - Recommend qualified counsel when compliance matters; document what was implemented (technical) vs. what still needs legal verification.
15
+
16
+ ## Process
17
+
18
+ 1. Identify product functionality.
19
+ 2. Flag potentially regulated features (age gates, emails, subscriptions, user content).
20
+ 3. Identify jurisdictions: where users are located, where the business is.
21
+ 4. Research potentially applicable laws (COPPA, CAN-SPAM, etc.).
22
+ 5. Distinguish technical requirements from legal requirements.
23
+ 6. Implement technical controls.
24
+ 7. Document remaining compliance responsibilities (legal/business verification).
25
+ 8. Recommend legal review.
26
+
27
+ ## Compliance Areas
28
+
29
+ ### Children / Age Restrictions — COPPA (U.S.)
30
+ - Applies when: service directed to children under 13, or actual knowledge of users under 13. Verify jurisdiction and applicability; check current FTC guidance if COPPA may apply.
31
+ - Requirements if applicable: privacy policy; parental notice; parental consent for data collection; parental access to child's information; data security; data retention/deletion.
32
+ - Technical controls: age gate/verification; parental consent mechanism; privacy policy; data minimization for children; deletion mechanism.
33
+ - Distinguish actual requirements from precautionary measures; never hardcode per-violation fines.
34
+ - Record: minimum age (e.g., 13/16/18 or "no restriction"), age verification, parental consent, children's data handling, legal review needed.
35
+
36
+ ### Marketing Emails — CAN-SPAM (U.S.)
37
+ - Applies when: commercial messages sent to U.S. recipients. Not the only email law — verify whether GDPR, CASL (Canada), or others apply. Distinguish transactional from marketing emails.
38
+ - Requirements if applicable: clear sender identification; accurate From/To/routing information; non-deceptive subject lines; message identified as advertisement where required.
39
+ - Also required: valid physical postal address; clear opt-out mechanism; honor opt-outs promptly (within 10 business days).
40
+ - Technical controls: unsubscribe link; unsubscribe processing system; suppression list; sender identification; physical address in footer; consent tracking.
41
+ - Never hardcode per-email penalties.
42
+ - Record: email types (transactional/marketing/both), unsubscribe mechanism, sender ID, address inclusion, consent mechanism, legal review needed.
43
+
44
+ ### Subscriptions & Auto-Renewals — U.S. state laws (e.g., California)
45
+ - Applies when: recurring billing, subscription plans, automatic renewals, free trials converting to paid. Requirements vary by state/country; never treat California law as universal or hardcode state requirements as global.
46
+ - Potential requirements: clear disclosure of subscription terms, automatic renewal, and cancellation method; renewal reminders (some jurisdictions); cancellation processing. Material terms clear at signup.
47
+ - Technical controls: prominent display of price, billing frequency, renewal terms, trial duration/conversion, cancellation method; accessible cancellation mechanism; renewal confirmations; receipts.
48
+ - Record: plans, auto-renewal (Yes/No), disclosure location, cancellation method, trial handling, jurisdictions needing legal review.
49
+
50
+ ### User-Generated Content — DMCA Safe Harbor (17 U.S.C. § 512, U.S. only)
51
+ - Conditional liability protection for online service providers; never claim automatic safe harbor. Safe harbor has specific technical and procedural requirements.
52
+ - Conditions: designated DMCA agent registered with the U.S. Copyright Office; publicly available agent contact information; notice-and-takedown process; counter-notice process; repeat infringer policy; no actual knowledge of infringement; no financial benefit from infringement.
53
+ - Technical controls: copyright policy; DMCA agent designation; takedown request form; content flagging system; repeat infringer tracking; user content licensing terms.
54
+ - Verify current U.S. Copyright Office requirements; never hardcode registration fees (they change); DMCA does not apply outside the U.S.
55
+ - Record: content types, copyright policy status, DMCA agent status, takedown process, repeat infringer policy, legal review needed.
258
56
 
259
57
  ### Privacy & Data Protection
260
-
261
- See `privacy-compliance.md` for detailed privacy considerations.
262
-
263
- Key areas:
264
- - Personal data collection transparency
265
- - Third-party data sharing
266
- - Cookie/tracking consent
267
- - Data retention and deletion
268
- - Cross-border data transfers
269
- - Privacy policy
270
-
271
- ---
272
-
273
- ## Implementation Checklist
274
-
275
- ### For ANY Regulated Feature
276
-
277
- - [ ] Identify the feature type (age restriction, email, subscription, user content, etc.)
278
- - [ ] Research potentially applicable laws
279
- - [ ] Identify relevant jurisdictions
280
- - [ ] Distinguish technical requirements from legal requirements
281
- - [ ] Implement necessary technical controls
282
- - [ ] Document what was implemented
283
- - [ ] Document what requires legal verification
284
- - [ ] Recommend legal review to user
285
- - [ ] Never claim "compliant" without proper verification
286
-
287
- ---
288
-
289
- ## Documentation Template
290
-
291
- When documenting compliance considerations:
292
-
293
- ```markdown
294
- ## [Compliance Area: e.g., Marketing Emails]
295
-
296
- ### Feature Description
297
- [What the product does]
298
-
299
- ### Potentially Applicable Laws
300
- - [Law 1: e.g., CAN-SPAM (U.S.)]
301
- - [Law 2: e.g., GDPR (EU) if applicable]
302
- - [Note: Verify applicability with legal counsel]
303
-
304
- ### Technical Controls Implemented
305
- - [Control 1: e.g., Unsubscribe link in all marketing emails]
306
- - [Control 2: e.g., Suppression list processing]
307
-
308
- ### Remaining Compliance Responsibilities
309
- - [ ] Verify applicable jurisdiction-specific requirements
310
- - [ ] Review consent mechanisms with legal counsel
311
- - [ ] Confirm physical address requirement
312
- - [ ] Verify transactional vs. marketing classification
313
-
314
- ### Legal Review Status
315
- - [ ] Not started
316
- - [ ] In progress
317
- - [ ] Complete
318
-
319
- ### Notes
320
- [Additional context]
321
- ```
322
-
323
- ---
324
-
325
- ## Critical Guardrails
326
-
327
- ### What AI Agents MUST DO
328
-
329
- ✅ Identify regulated functionality
330
- ✅ Research potentially applicable laws
331
- ✅ Implement technical controls where appropriate
332
- ✅ Document compliance considerations
333
- ✅ Distinguish technical from legal requirements
334
- ✅ Recommend legal counsel when compliance matters
335
- ✅ Verify current requirements from authoritative sources when accuracy matters
336
-
337
- ### What AI Agents MUST NOT DO
338
-
339
- ❌ Claim "legally compliant" without verification
340
- ❌ Invent legal requirements
341
- ❌ Hardcode penalties or fines as permanent facts
342
- ❌ Assume one jurisdiction's rules apply globally
343
- ❌ Pretend to be a lawyer or law firm
344
- ❌ Make definitive legal conclusions
345
- ❌ Give legal advice
346
-
347
- ---
348
-
349
- ## Jurisdiction Considerations
350
-
351
- ### United States
352
- - Federal laws (COPPA, CAN-SPAM, DMCA, etc.)
353
- - State laws (California, Virginia, Colorado privacy laws, etc.)
354
- - Industry-specific regulations (HIPAA, GLBA, etc.)
355
-
356
- ### European Union
357
- - GDPR (General Data Protection Regulation)
358
- - ePrivacy Directive
359
- - Digital Services Act
360
- - AI Act (emerging)
361
-
362
- ### Other Jurisdictions
363
- - Canada: PIPEDA, CASL
364
- - UK: UK GDPR, DPA 2018
365
- - Australia: Privacy Act
366
- - Brazil: LGPD
367
- - Many others
368
-
369
- **Key point:** Requirements vary by jurisdiction. Never assume universal rules.
370
-
371
- ---
372
-
373
- ## When to Escalate to Legal Counsel
374
-
375
- Recommend legal review when:
58
+ - See `privacy-compliance.md`: collection transparency, third-party sharing, cookie/tracking consent, retention/deletion, cross-border transfers, privacy policy.
59
+
60
+ ## Jurisdictions (verify applicability; never assume universal rules)
61
+
62
+ | Region | Laws to consider |
63
+ |---|---|
64
+ | U.S. federal | COPPA, CAN-SPAM, DMCA |
65
+ | U.S. states | California, Virginia, Colorado privacy laws; state auto-renewal laws |
66
+ | U.S. industry-specific | HIPAA, GLBA |
67
+ | EU | GDPR, ePrivacy Directive, Digital Services Act, AI Act (emerging) |
68
+ | Canada | PIPEDA, CASL |
69
+ | UK | UK GDPR, DPA 2018 |
70
+ | Australia | Privacy Act |
71
+ | Brazil | LGPD |
72
+
73
+ ## Checklist — Any Regulated Feature
74
+
75
+ - [ ] Feature type identified (age restriction, email, subscription, user content, etc.)
76
+ - [ ] Potentially applicable laws researched; relevant jurisdictions identified
77
+ - [ ] Technical requirements distinguished from legal requirements
78
+ - [ ] Technical controls implemented; changed behavior verified
79
+ - [ ] Implemented controls documented; remaining legal/business verification documented
80
+ - [ ] Legal review recommended to user
81
+ - [ ] No "compliant" claim without proper verification
82
+
83
+ ## Documentation Template (per compliance area)
84
+
85
+ - Feature description: what the product does
86
+ - Potentially applicable laws (e.g., CAN-SPAM U.S.; GDPR EU if applicable) — verify applicability with counsel
87
+ - Technical controls implemented (e.g., unsubscribe link in all marketing emails, suppression list processing)
88
+ - Remaining responsibilities: jurisdiction-specific requirements, consent review with counsel, physical address confirmation, transactional vs. marketing classification
89
+ - Legal review status: Not started / In progress / Complete
90
+ - Notes: additional context
91
+
92
+ ## Escalate to Legal Counsel When
376
93
 
377
94
  - Service collects children's information
378
95
  - Service sends marketing emails at scale
@@ -383,26 +100,4 @@ Recommend legal review when:
383
100
  - Service has cross-border data transfers
384
101
  - Compliance requirements are unclear
385
102
  - Penalties for non-compliance are significant
386
- - Business risk tolerance is low
387
-
388
- ---
389
-
390
- ## Summary
391
-
392
- This skill system helps AI agents:
393
-
394
- 1. **Identify** potentially applicable legal/compliance considerations
395
- 2. **Implement** appropriate technical controls
396
- 3. **Document** compliance efforts
397
- 4. **Recommend** legal review when appropriate
398
- 5. **Never pretend** to be a lawyer
399
-
400
- **Remember:**
401
- - This is engineering guidance, not legal advice
402
- - Laws vary by jurisdiction
403
- - Requirements change over time
404
- - Verify with qualified legal counsel
405
- - Document what you implement
406
- - Don't fabricate compliance claims
407
-
408
- **Goal:** Prevent common legal oversights while acknowledging the limits of AI legal knowledge.
103
+ - Business risk tolerance is low