telo3-ai 5.0.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.
- package/AI-CONTEXT.md +263 -0
- package/LICENSE +21 -0
- package/ONBOARDING-SKILL.md +728 -0
- package/README.md +801 -0
- package/SKILL-METADATA.json +237 -0
- package/SKILL.md +666 -0
- package/cli.js +84 -0
- package/index.js +65 -0
- package/package.json +97 -0
- package/references/accessibility-quality.md +278 -0
- package/references/ai-behavior.md +363 -0
- package/references/document-specification.md +425 -0
- package/references/legal-compliance.md +408 -0
- package/references/performance-quality.md +351 -0
- package/references/privacy-compliance.md +494 -0
- package/references/project-audit.md +468 -0
- package/references/security-quality.md +254 -0
- package/references/seo-quality.md +347 -0
- package/references/smart-skill-delegation.md +451 -0
- package/references/token-optimization.md +481 -0
- package/references/ui-quality.md +491 -0
- package/references/workflow.md +474 -0
- package/scripts/init-project-context.sh +139 -0
- package/scripts/validate-project-context.sh +164 -0
- package/templates/architecture.md +418 -0
- package/templates/design.md +654 -0
- package/templates/memory.md +368 -0
- package/templates/prd.md +320 -0
- package/templates/rules.md +619 -0
- package/templates/tasks.md +220 -0
|
@@ -0,0 +1,408 @@
|
|
|
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
|
+
---
|
|
258
|
+
|
|
259
|
+
### 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:
|
|
376
|
+
|
|
377
|
+
- Service collects children's information
|
|
378
|
+
- Service sends marketing emails at scale
|
|
379
|
+
- Service has recurring billing or subscriptions
|
|
380
|
+
- Service hosts user-generated content
|
|
381
|
+
- Service collects sensitive personal data (health, financial, biometric)
|
|
382
|
+
- Service operates in regulated industries (healthcare, finance)
|
|
383
|
+
- Service has cross-border data transfers
|
|
384
|
+
- Compliance requirements are unclear
|
|
385
|
+
- 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.
|