@lifeaitools/rdc-skills 0.24.42 → 0.25.1
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/.claude/settings.json +15 -15
- package/.claude-plugin/marketplace.json +21 -21
- package/.claude-plugin/plugin.json +1560 -1371
- package/.github/workflows/publish.yml +34 -34
- package/.github/workflows/self-test.yml +58 -58
- package/CHANGELOG.md +322 -310
- package/LICENSE +21 -21
- package/MANIFEST.md +224 -221
- package/README.md +377 -376
- package/README.sandbox.md +3 -3
- package/assets/watcher/viewer.html +164 -164
- package/bin/rdc-skills-mcp.mjs +316 -316
- package/commands/build.md +183 -183
- package/commands/collab.md +180 -180
- package/commands/deploy.md +152 -152
- package/commands/design.md +31 -31
- package/commands/edit.md +28 -28
- package/commands/fixit.md +150 -124
- package/commands/handoff.md +173 -173
- package/commands/help.md +95 -95
- package/commands/overnight.md +220 -220
- package/commands/plan.md +158 -158
- package/commands/preplan.md +131 -131
- package/commands/prototype.md +145 -145
- package/commands/release.md +49 -49
- package/commands/report.md +99 -99
- package/commands/review.md +120 -120
- package/commands/self-test.md +113 -113
- package/commands/status.md +86 -86
- package/commands/watch.md +98 -98
- package/commands/workitems.md +137 -137
- package/git-sha.json +1 -1
- package/guides/agent-bootstrap.md +295 -295
- package/guides/agents/backend.md +104 -104
- package/guides/agents/content.md +94 -94
- package/guides/agents/cs2.md +56 -56
- package/guides/agents/data.md +87 -87
- package/guides/agents/design.md +77 -77
- package/guides/agents/frontend.md +92 -92
- package/guides/agents/infrastructure.md +81 -81
- package/guides/agents/setup.md +281 -281
- package/guides/agents/verify.md +151 -151
- package/guides/agents/viz.md +106 -106
- package/guides/backend.md +146 -146
- package/guides/content.md +147 -147
- package/guides/cs2.md +190 -190
- package/guides/data.md +123 -123
- package/guides/design.md +116 -116
- package/guides/engineering-behavior.md +43 -43
- package/guides/escalation-protocol.md +125 -125
- package/guides/frontend.md +151 -151
- package/guides/history-md-spec.md +297 -297
- package/guides/infrastructure.md +179 -179
- package/guides/lessons-learned-spec.md +145 -151
- package/guides/output-contract.md +108 -108
- package/guides/publish-md-spec.md +289 -289
- package/guides/rdc-skills-startup.md +30 -30
- package/guides/verify.md +11 -11
- package/hooks/check-cwd.js +31 -31
- package/hooks/check-rdc-environment.js +164 -164
- package/hooks/check-services.js +6 -6
- package/hooks/check-stale-work-items.js +19 -19
- package/hooks/foreground-process-gate.js +128 -128
- package/hooks/gate-watchdog-selfcheck.js +257 -257
- package/hooks/hook-logger.js +25 -25
- package/hooks/lib/run-evidence-gate.mjs +241 -241
- package/hooks/no-stop-open-epics.js +127 -127
- package/hooks/post-tool-batch-gate.js +203 -203
- package/hooks/post-work-check.js +21 -21
- package/hooks/postcompact-log.js +13 -13
- package/hooks/precompact-log.js +13 -13
- package/hooks/rate-limit-retry.js +46 -46
- package/hooks/rdc-invocation-marker.js +157 -157
- package/hooks/rdc-output-contract-gate.js +94 -94
- package/hooks/require-work-item-on-commit.js +294 -294
- package/hooks/restart-brief.js +19 -19
- package/hooks/run-hidden-hook.ps1 +47 -47
- package/hooks/task-completed-gate.js +274 -274
- package/hooks/work-item-exit-gate.js +944 -944
- package/lib/catalog.mjs +236 -236
- package/lib/cloud-rewrite.mjs +155 -155
- package/package.json +57 -57
- package/rules/work-items-rpc.md +520 -520
- package/scaffold/templates/HISTORY.md.template +39 -39
- package/scaffold/templates/PUBLISH.md.template +21 -21
- package/scaffold/templates/brochure-studio-default.html +70 -70
- package/scripts/acceptance.mjs +502 -502
- package/scripts/fixtures/guides/bad-guide.md +15 -15
- package/scripts/fixtures/guides-clean/good-guide.md +16 -16
- package/scripts/install-rdc-skills.js +1401 -1289
- package/scripts/install.ps1 +202 -202
- package/scripts/install.sh +132 -132
- package/scripts/lib/assertions.mjs +287 -287
- package/scripts/lib/manifest-schema.mjs +754 -754
- package/scripts/lib/runner.mjs +465 -465
- package/scripts/lib/sandbox.mjs +435 -435
- package/scripts/prepack.mjs +32 -32
- package/scripts/rdc-brochure.mjs +482 -482
- package/scripts/rdc-design-cli.mjs +134 -134
- package/scripts/rebuild-mcp.mjs +107 -107
- package/scripts/self-test.mjs +1460 -1460
- package/scripts/stamp-git-sha.mjs +29 -29
- package/scripts/test-guide-validator.mjs +196 -196
- package/scripts/test-rdc-hooks.mjs +145 -145
- package/scripts/uninstall.ps1 +77 -77
- package/scripts/uninstall.sh +69 -69
- package/scripts/update.ps1 +43 -43
- package/scripts/update.sh +43 -43
- package/scripts/validate-place-histories.js +461 -461
- package/scripts/validate-publish-manifests.js +502 -424
- package/scripts/watch-init.mjs +100 -100
- package/skills/brochure/SKILL.md +107 -107
- package/skills/build/SKILL.md +578 -563
- package/skills/channel-formatter/SKILL.md +538 -533
- package/skills/co-develop/SKILL.md +196 -196
- package/skills/collab/SKILL.md +239 -239
- package/skills/convert/SKILL.md +167 -140
- package/skills/deploy/SKILL.md +541 -541
- package/skills/design/SKILL.md +211 -211
- package/skills/design/reference/ownership.md +16 -16
- package/skills/design/reference/rampa.md +92 -92
- package/skills/design/reference/studio-model.md +153 -153
- package/skills/edit/SKILL.md +98 -98
- package/skills/env/SKILL.md +141 -0
- package/skills/fixit/SKILL.md +203 -165
- package/skills/fs-mcp/SKILL.md +183 -148
- package/skills/handoff/SKILL.md +236 -236
- package/skills/help/SKILL.md +143 -143
- package/skills/housekeeping/SKILL.md +160 -219
- package/skills/lifeai-brochure-author/SKILL.md +340 -340
- package/skills/new-model/SKILL.md +49 -0
- package/skills/onramp/SKILL.md +1459 -0
- package/skills/overnight/SKILL.md +251 -251
- package/skills/plan/SKILL.md +345 -345
- package/skills/preplan/SKILL.md +90 -90
- package/skills/prototype/SKILL.md +150 -150
- package/skills/rdc-brochurify/SKILL.md +245 -245
- package/skills/rdc-extract-verifier-rules/SKILL.md +191 -191
- package/skills/regen-media/SKILL.md +94 -0
- package/skills/release/SKILL.md +140 -140
- package/skills/report/SKILL.md +100 -100
- package/skills/review/SKILL.md +160 -152
- package/skills/rpms-filemap/SKILL.cloud.md +111 -111
- package/skills/rpms-filemap/SKILL.md +111 -111
- package/skills/self-test/SKILL.md +132 -132
- package/skills/status/SKILL.md +99 -99
- package/skills/terminal-config/SKILL.md +62 -62
- package/skills/tests/MATRIX.md +55 -54
- package/skills/tests/README.md +47 -47
- package/skills/tests/onramp.test.json +87 -0
- package/skills/tests/rdc-brochure.test.json +34 -34
- package/skills/tests/rdc-build.test.json +36 -36
- package/skills/tests/rdc-channel-formatter.test.json +45 -45
- package/skills/tests/rdc-co-develop.test.json +29 -29
- package/skills/tests/rdc-collab.test.json +29 -29
- package/skills/tests/rdc-convert.test.json +35 -35
- package/skills/tests/rdc-deploy.test.json +30 -30
- package/skills/tests/rdc-design.test.json +27 -27
- package/skills/tests/rdc-edit.test.json +29 -29
- package/skills/tests/rdc-fixit.test.json +36 -36
- package/skills/tests/rdc-fs-mcp.test.json +36 -36
- package/skills/tests/rdc-handoff.test.json +28 -28
- package/skills/tests/rdc-help.test.json +29 -29
- package/skills/tests/rdc-housekeeping.test.json +28 -32
- package/skills/tests/rdc-lifeai-brochure-author.test.json +35 -35
- package/skills/tests/rdc-overnight.test.json +37 -37
- package/skills/tests/rdc-plan.test.json +27 -27
- package/skills/tests/rdc-preplan.test.json +31 -31
- package/skills/tests/rdc-prototype.test.json +28 -28
- package/skills/tests/rdc-rdc-brochurify.test.json +23 -23
- package/skills/tests/rdc-rdc-extract-verifier-rules.test.json +34 -34
- package/skills/tests/rdc-regen-media.test.json +29 -0
- package/skills/tests/rdc-release.test.json +29 -29
- package/skills/tests/rdc-report.test.json +28 -28
- package/skills/tests/rdc-review.test.json +29 -29
- package/skills/tests/rdc-rpms-filemap.test.json +28 -28
- package/skills/tests/rdc-self-test.test.json +24 -24
- package/skills/tests/rdc-status.test.json +29 -29
- package/skills/tests/rdc-terminal-config.test.json +29 -29
- package/skills/tests/rdc-watch.test.json +24 -24
- package/skills/tests/rdc-workitems.test.json +27 -27
- package/skills/watch/SKILL.md +97 -97
- package/skills/workitems/SKILL.md +151 -151
- package/tests/acceptance.test.mjs +59 -59
- package/tests/channel-formatter.contract.test.mjs +251 -251
- package/tests/curl-surface.test.mjs +289 -289
- package/tests/harness-gates.test.mjs +325 -325
- package/tests/help-surface.test.mjs +61 -61
- package/tests/install-rdc-skills.test.mjs +49 -49
- package/tests/manifest-contract-fields.test.mjs +78 -78
- package/tests/mcp.test.mjs +271 -271
- package/tests/rdc-brochure.test.mjs +125 -125
- package/tests/require-work-item-on-commit.test.mjs +162 -162
- package/tests/run-evidence-gate.test.mjs +82 -82
- package/tests/skill-test-matrix.test.mjs +66 -66
- package/tests/validate-skills.js +27 -27
- package/tests/work-item-exit-gate-l2.test.mjs +368 -368
- package/tests/work-item-exit-gate-l3.test.mjs +197 -197
- package/RELEASE.md +0 -42
- package/tests/housekeeping-lessons-triage.test.mjs +0 -49
- package/tests/lessons-pipeline-contract.test.mjs +0 -27
- package/tests/release-contract.test.mjs +0 -16
package/guides/backend.md
CHANGED
|
@@ -1,146 +1,146 @@
|
|
|
1
|
-
# Backend Agent Guide — Base
|
|
2
|
-
> Role-based context for backend/API/data agents. Generic patterns across projects.
|
|
3
|
-
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
## Database Client Patterns
|
|
7
|
-
|
|
8
|
-
Every project specifies its database client library. Always use that instead of writing raw SQL.
|
|
9
|
-
|
|
10
|
-
Generic server component pattern:
|
|
11
|
-
```ts
|
|
12
|
-
// Server component / API route
|
|
13
|
-
const client = await createServerClient();
|
|
14
|
-
const { data, error } = await client.from("table").select("*");
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
Generic browser component pattern:
|
|
18
|
-
```ts
|
|
19
|
-
// Client component
|
|
20
|
-
const client = createBrowserClient();
|
|
21
|
-
const { data, error } = await client.from("table").select("*");
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
The project overlay specifies:
|
|
25
|
-
- Import path for server client
|
|
26
|
-
- Import path for browser client
|
|
27
|
-
- How to access non-public schemas
|
|
28
|
-
- Authentication requirements
|
|
29
|
-
|
|
30
|
-
---
|
|
31
|
-
|
|
32
|
-
## Environment Variables
|
|
33
|
-
|
|
34
|
-
```bash
|
|
35
|
-
# Required in every app
|
|
36
|
-
# (Project overlay specifies exact variable names and format)
|
|
37
|
-
SERVICE_URL=https://...
|
|
38
|
-
SERVICE_ANON_KEY=...
|
|
39
|
-
|
|
40
|
-
# Server-side only (never prefix with PUBLIC_)
|
|
41
|
-
SERVICE_ADMIN_KEY=...
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
The project overlay specifies:
|
|
45
|
-
- Exact variable names
|
|
46
|
-
- Which are public vs server-only
|
|
47
|
-
- Where to retrieve credentials
|
|
48
|
-
|
|
49
|
-
---
|
|
50
|
-
|
|
51
|
-
## Auth Patterns
|
|
52
|
-
|
|
53
|
-
Projects typically provide auth helpers. Check project overlay for:
|
|
54
|
-
- `getUser()` — nullable, server-side only
|
|
55
|
-
- `requireAuth()` — throws if unauthenticated
|
|
56
|
-
- Middleware patterns (public pass-through vs protected)
|
|
57
|
-
- Login method (magic link, OAuth, etc.)
|
|
58
|
-
|
|
59
|
-
---
|
|
60
|
-
|
|
61
|
-
## Work Items / Task Management
|
|
62
|
-
|
|
63
|
-
Most projects have a task/epic system. The project overlay specifies:
|
|
64
|
-
- Whether to use RPC functions or raw SQL
|
|
65
|
-
- Required fields and enums
|
|
66
|
-
- Relationship patterns (parent/child hierarchy)
|
|
67
|
-
- Which operations require special handling
|
|
68
|
-
|
|
69
|
-
Never guess at the implementation — read the project overlay.
|
|
70
|
-
|
|
71
|
-
---
|
|
72
|
-
|
|
73
|
-
## API Route Patterns
|
|
74
|
-
|
|
75
|
-
```ts
|
|
76
|
-
// app/api/example/route.ts
|
|
77
|
-
import { createServerClient } from "@project/db";
|
|
78
|
-
import { NextResponse } from "next/server";
|
|
79
|
-
|
|
80
|
-
export async function GET() {
|
|
81
|
-
const client = await createServerClient();
|
|
82
|
-
const { data, error } = await client.from("table").select("*");
|
|
83
|
-
if (error) return NextResponse.json({ error: error.message }, { status: 500 });
|
|
84
|
-
return NextResponse.json(data);
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
export async function POST(request: Request) {
|
|
88
|
-
const body = await request.json();
|
|
89
|
-
const client = await createServerClient();
|
|
90
|
-
const { data, error } = await client.from("table").insert(body).select().single();
|
|
91
|
-
if (error) return NextResponse.json({ error: error.message }, { status: 400 });
|
|
92
|
-
return NextResponse.json(data, { status: 201 });
|
|
93
|
-
}
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
---
|
|
97
|
-
|
|
98
|
-
## Schema-Driven Forms
|
|
99
|
-
|
|
100
|
-
Some projects use dynamic schema tables for form generation. The project overlay specifies:
|
|
101
|
-
- Table for field schema
|
|
102
|
-
- Components that read schema at runtime (DynamicForm, AdaptiveCrud, etc.)
|
|
103
|
-
- Never hardcode form columns
|
|
104
|
-
|
|
105
|
-
---
|
|
106
|
-
|
|
107
|
-
## Credential Safety
|
|
108
|
-
|
|
109
|
-
The project overlay specifies:
|
|
110
|
-
- Where credentials come from (MCP, daemon, env vars)
|
|
111
|
-
- Never print keys to stdout
|
|
112
|
-
- Never hardcode credentials in source
|
|
113
|
-
- Never ask the user for keys
|
|
114
|
-
- If daemon/service is down: report BLOCKED, do not work around
|
|
115
|
-
|
|
116
|
-
---
|
|
117
|
-
|
|
118
|
-
## Key Schema Domains (Check Project Overlay)
|
|
119
|
-
|
|
120
|
-
The project specifies its schema structure:
|
|
121
|
-
- Which tables exist in which schemas
|
|
122
|
-
- Primary keys and foreign relationships
|
|
123
|
-
- RLS policies and access rules
|
|
124
|
-
- Materialized views or special queries
|
|
125
|
-
|
|
126
|
-
Never assume schema structure — read the project overlay.
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
|
-
## Migration Patterns
|
|
131
|
-
|
|
132
|
-
The project overlay specifies:
|
|
133
|
-
- Where migration files live
|
|
134
|
-
- How to apply migrations
|
|
135
|
-
- How to verify migrations
|
|
136
|
-
- Which database service to use
|
|
137
|
-
|
|
138
|
-
---
|
|
139
|
-
|
|
140
|
-
## Specialist Context — Read Project Overlay
|
|
141
|
-
|
|
142
|
-
Your task may require reading additional project-specific guides for:
|
|
143
|
-
- Full DB schema with all columns
|
|
144
|
-
- Deployment registry patterns
|
|
145
|
-
- Brand token API
|
|
146
|
-
- Auth patterns beyond basics
|
|
1
|
+
# Backend Agent Guide — Base
|
|
2
|
+
> Role-based context for backend/API/data agents. Generic patterns across projects.
|
|
3
|
+
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
## Database Client Patterns
|
|
7
|
+
|
|
8
|
+
Every project specifies its database client library. Always use that instead of writing raw SQL.
|
|
9
|
+
|
|
10
|
+
Generic server component pattern:
|
|
11
|
+
```ts
|
|
12
|
+
// Server component / API route
|
|
13
|
+
const client = await createServerClient();
|
|
14
|
+
const { data, error } = await client.from("table").select("*");
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Generic browser component pattern:
|
|
18
|
+
```ts
|
|
19
|
+
// Client component
|
|
20
|
+
const client = createBrowserClient();
|
|
21
|
+
const { data, error } = await client.from("table").select("*");
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
The project overlay specifies:
|
|
25
|
+
- Import path for server client
|
|
26
|
+
- Import path for browser client
|
|
27
|
+
- How to access non-public schemas
|
|
28
|
+
- Authentication requirements
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## Environment Variables
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
# Required in every app
|
|
36
|
+
# (Project overlay specifies exact variable names and format)
|
|
37
|
+
SERVICE_URL=https://...
|
|
38
|
+
SERVICE_ANON_KEY=...
|
|
39
|
+
|
|
40
|
+
# Server-side only (never prefix with PUBLIC_)
|
|
41
|
+
SERVICE_ADMIN_KEY=...
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
The project overlay specifies:
|
|
45
|
+
- Exact variable names
|
|
46
|
+
- Which are public vs server-only
|
|
47
|
+
- Where to retrieve credentials
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Auth Patterns
|
|
52
|
+
|
|
53
|
+
Projects typically provide auth helpers. Check project overlay for:
|
|
54
|
+
- `getUser()` — nullable, server-side only
|
|
55
|
+
- `requireAuth()` — throws if unauthenticated
|
|
56
|
+
- Middleware patterns (public pass-through vs protected)
|
|
57
|
+
- Login method (magic link, OAuth, etc.)
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## Work Items / Task Management
|
|
62
|
+
|
|
63
|
+
Most projects have a task/epic system. The project overlay specifies:
|
|
64
|
+
- Whether to use RPC functions or raw SQL
|
|
65
|
+
- Required fields and enums
|
|
66
|
+
- Relationship patterns (parent/child hierarchy)
|
|
67
|
+
- Which operations require special handling
|
|
68
|
+
|
|
69
|
+
Never guess at the implementation — read the project overlay.
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## API Route Patterns
|
|
74
|
+
|
|
75
|
+
```ts
|
|
76
|
+
// app/api/example/route.ts
|
|
77
|
+
import { createServerClient } from "@project/db";
|
|
78
|
+
import { NextResponse } from "next/server";
|
|
79
|
+
|
|
80
|
+
export async function GET() {
|
|
81
|
+
const client = await createServerClient();
|
|
82
|
+
const { data, error } = await client.from("table").select("*");
|
|
83
|
+
if (error) return NextResponse.json({ error: error.message }, { status: 500 });
|
|
84
|
+
return NextResponse.json(data);
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
export async function POST(request: Request) {
|
|
88
|
+
const body = await request.json();
|
|
89
|
+
const client = await createServerClient();
|
|
90
|
+
const { data, error } = await client.from("table").insert(body).select().single();
|
|
91
|
+
if (error) return NextResponse.json({ error: error.message }, { status: 400 });
|
|
92
|
+
return NextResponse.json(data, { status: 201 });
|
|
93
|
+
}
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## Schema-Driven Forms
|
|
99
|
+
|
|
100
|
+
Some projects use dynamic schema tables for form generation. The project overlay specifies:
|
|
101
|
+
- Table for field schema
|
|
102
|
+
- Components that read schema at runtime (DynamicForm, AdaptiveCrud, etc.)
|
|
103
|
+
- Never hardcode form columns
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## Credential Safety
|
|
108
|
+
|
|
109
|
+
The project overlay specifies:
|
|
110
|
+
- Where credentials come from (MCP, daemon, env vars)
|
|
111
|
+
- Never print keys to stdout
|
|
112
|
+
- Never hardcode credentials in source
|
|
113
|
+
- Never ask the user for keys
|
|
114
|
+
- If daemon/service is down: report BLOCKED, do not work around
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## Key Schema Domains (Check Project Overlay)
|
|
119
|
+
|
|
120
|
+
The project specifies its schema structure:
|
|
121
|
+
- Which tables exist in which schemas
|
|
122
|
+
- Primary keys and foreign relationships
|
|
123
|
+
- RLS policies and access rules
|
|
124
|
+
- Materialized views or special queries
|
|
125
|
+
|
|
126
|
+
Never assume schema structure — read the project overlay.
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## Migration Patterns
|
|
131
|
+
|
|
132
|
+
The project overlay specifies:
|
|
133
|
+
- Where migration files live
|
|
134
|
+
- How to apply migrations
|
|
135
|
+
- How to verify migrations
|
|
136
|
+
- Which database service to use
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## Specialist Context — Read Project Overlay
|
|
141
|
+
|
|
142
|
+
Your task may require reading additional project-specific guides for:
|
|
143
|
+
- Full DB schema with all columns
|
|
144
|
+
- Deployment registry patterns
|
|
145
|
+
- Brand token API
|
|
146
|
+
- Auth patterns beyond basics
|
package/guides/content.md
CHANGED
|
@@ -1,147 +1,147 @@
|
|
|
1
|
-
# Content Agent Guide — Base
|
|
2
|
-
> Role-based context for content, copywriting, and messaging agents. Generic patterns across projects.
|
|
3
|
-
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
## Core Messaging
|
|
7
|
-
|
|
8
|
-
Every project has a core message and lead word. Check the overlay for:
|
|
9
|
-
- The single most important concept
|
|
10
|
-
- The tone and voice (formal, friendly, technical, etc.)
|
|
11
|
-
- Key messages and themes
|
|
12
|
-
- Audience segments and their pain points
|
|
13
|
-
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
## Language Rules
|
|
17
|
-
|
|
18
|
-
The project specifies:
|
|
19
|
-
- Words/phrases to ALWAYS use
|
|
20
|
-
- Words/phrases to NEVER use alone
|
|
21
|
-
- Synonyms to prefer
|
|
22
|
-
- Jargon levels (when to use, when to avoid)
|
|
23
|
-
- Metaphors and analogies that resonate
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## Regulatory Context
|
|
28
|
-
|
|
29
|
-
Check the overlay for:
|
|
30
|
-
- Compliance framework (Reg D, HIPAA, etc.)
|
|
31
|
-
- Disclaimers required
|
|
32
|
-
- Language restrictions (cannot guarantee, cannot claim, etc.)
|
|
33
|
-
- When to involve legal review
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
## Audience Segments
|
|
38
|
-
|
|
39
|
-
The project defines segments with:
|
|
40
|
-
- Pain points
|
|
41
|
-
- What they care about
|
|
42
|
-
- Key values
|
|
43
|
-
- Messaging hooks per segment
|
|
44
|
-
- Success metrics
|
|
45
|
-
|
|
46
|
-
Tailor messaging per segment.
|
|
47
|
-
|
|
48
|
-
---
|
|
49
|
-
|
|
50
|
-
## Key Acronyms and Terminology
|
|
51
|
-
|
|
52
|
-
The project provides:
|
|
53
|
-
- List of acronyms and full names
|
|
54
|
-
- When to use acronym vs full name
|
|
55
|
-
- Related concepts and distinctions
|
|
56
|
-
- Pronunciation (if needed)
|
|
57
|
-
|
|
58
|
-
---
|
|
59
|
-
|
|
60
|
-
## Brand Positioning
|
|
61
|
-
|
|
62
|
-
The project specifies:
|
|
63
|
-
- Brand promise
|
|
64
|
-
- Competitive positioning
|
|
65
|
-
- Unique value proposition
|
|
66
|
-
- Brand personality
|
|
67
|
-
|
|
68
|
-
---
|
|
69
|
-
|
|
70
|
-
## Architecture and Offerings
|
|
71
|
-
|
|
72
|
-
The project describes:
|
|
73
|
-
- Product/service offerings
|
|
74
|
-
- How they work together
|
|
75
|
-
- Key features and benefits
|
|
76
|
-
- Pricing/tier structure (if applicable)
|
|
77
|
-
|
|
78
|
-
---
|
|
79
|
-
|
|
80
|
-
## Key Financial/Impact Facts
|
|
81
|
-
|
|
82
|
-
The project provides:
|
|
83
|
-
- Headline metrics (fund size, returns, impact, etc.)
|
|
84
|
-
- Ranges vs absolutes
|
|
85
|
-
- How to cite data
|
|
86
|
-
- What claims require support
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
## Contact Information
|
|
91
|
-
|
|
92
|
-
The project specifies:
|
|
93
|
-
- Primary contact person
|
|
94
|
-
- Contact method (email, phone, etc.)
|
|
95
|
-
- When different contacts are appropriate
|
|
96
|
-
- What to escalate
|
|
97
|
-
|
|
98
|
-
---
|
|
99
|
-
|
|
100
|
-
## Tone Guidelines
|
|
101
|
-
|
|
102
|
-
The project specifies:
|
|
103
|
-
- Voice characteristics (authoritative, friendly, technical, etc.)
|
|
104
|
-
- Active vs passive voice preference
|
|
105
|
-
- Sentence structure patterns
|
|
106
|
-
- Metaphor usage
|
|
107
|
-
- Humor guidelines
|
|
108
|
-
|
|
109
|
-
---
|
|
110
|
-
|
|
111
|
-
## Live Products / Offerings
|
|
112
|
-
|
|
113
|
-
The project lists:
|
|
114
|
-
- Current offerings (products, services, projects, etc.)
|
|
115
|
-
- Status (active, development, archived)
|
|
116
|
-
- Key features or differentiators
|
|
117
|
-
|
|
118
|
-
---
|
|
119
|
-
|
|
120
|
-
## Email Templates
|
|
121
|
-
|
|
122
|
-
Some projects use templated emails. Check overlay for:
|
|
123
|
-
- Email template library
|
|
124
|
-
- When to use canned vs custom
|
|
125
|
-
- Email formatting standards
|
|
126
|
-
- Signature blocks
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
|
-
## Campaign Engine
|
|
131
|
-
|
|
132
|
-
Some projects have automated campaigns. Check overlay for:
|
|
133
|
-
- Campaign template system
|
|
134
|
-
- Variable injection patterns
|
|
135
|
-
- Segment-specific personalization
|
|
136
|
-
- Scheduling and delivery rules
|
|
137
|
-
|
|
138
|
-
---
|
|
139
|
-
|
|
140
|
-
## Specialist Context — Read Project Overlay
|
|
141
|
-
|
|
142
|
-
Your task may require reading additional project-specific guides for:
|
|
143
|
-
- Complete acronym list
|
|
144
|
-
- Detailed financial facts
|
|
145
|
-
- Full audience segment profiles
|
|
146
|
-
- Campaign templates and examples
|
|
147
|
-
- Compliance and legal language requirements
|
|
1
|
+
# Content Agent Guide — Base
|
|
2
|
+
> Role-based context for content, copywriting, and messaging agents. Generic patterns across projects.
|
|
3
|
+
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
## Core Messaging
|
|
7
|
+
|
|
8
|
+
Every project has a core message and lead word. Check the overlay for:
|
|
9
|
+
- The single most important concept
|
|
10
|
+
- The tone and voice (formal, friendly, technical, etc.)
|
|
11
|
+
- Key messages and themes
|
|
12
|
+
- Audience segments and their pain points
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Language Rules
|
|
17
|
+
|
|
18
|
+
The project specifies:
|
|
19
|
+
- Words/phrases to ALWAYS use
|
|
20
|
+
- Words/phrases to NEVER use alone
|
|
21
|
+
- Synonyms to prefer
|
|
22
|
+
- Jargon levels (when to use, when to avoid)
|
|
23
|
+
- Metaphors and analogies that resonate
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Regulatory Context
|
|
28
|
+
|
|
29
|
+
Check the overlay for:
|
|
30
|
+
- Compliance framework (Reg D, HIPAA, etc.)
|
|
31
|
+
- Disclaimers required
|
|
32
|
+
- Language restrictions (cannot guarantee, cannot claim, etc.)
|
|
33
|
+
- When to involve legal review
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Audience Segments
|
|
38
|
+
|
|
39
|
+
The project defines segments with:
|
|
40
|
+
- Pain points
|
|
41
|
+
- What they care about
|
|
42
|
+
- Key values
|
|
43
|
+
- Messaging hooks per segment
|
|
44
|
+
- Success metrics
|
|
45
|
+
|
|
46
|
+
Tailor messaging per segment.
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## Key Acronyms and Terminology
|
|
51
|
+
|
|
52
|
+
The project provides:
|
|
53
|
+
- List of acronyms and full names
|
|
54
|
+
- When to use acronym vs full name
|
|
55
|
+
- Related concepts and distinctions
|
|
56
|
+
- Pronunciation (if needed)
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## Brand Positioning
|
|
61
|
+
|
|
62
|
+
The project specifies:
|
|
63
|
+
- Brand promise
|
|
64
|
+
- Competitive positioning
|
|
65
|
+
- Unique value proposition
|
|
66
|
+
- Brand personality
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Architecture and Offerings
|
|
71
|
+
|
|
72
|
+
The project describes:
|
|
73
|
+
- Product/service offerings
|
|
74
|
+
- How they work together
|
|
75
|
+
- Key features and benefits
|
|
76
|
+
- Pricing/tier structure (if applicable)
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## Key Financial/Impact Facts
|
|
81
|
+
|
|
82
|
+
The project provides:
|
|
83
|
+
- Headline metrics (fund size, returns, impact, etc.)
|
|
84
|
+
- Ranges vs absolutes
|
|
85
|
+
- How to cite data
|
|
86
|
+
- What claims require support
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## Contact Information
|
|
91
|
+
|
|
92
|
+
The project specifies:
|
|
93
|
+
- Primary contact person
|
|
94
|
+
- Contact method (email, phone, etc.)
|
|
95
|
+
- When different contacts are appropriate
|
|
96
|
+
- What to escalate
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## Tone Guidelines
|
|
101
|
+
|
|
102
|
+
The project specifies:
|
|
103
|
+
- Voice characteristics (authoritative, friendly, technical, etc.)
|
|
104
|
+
- Active vs passive voice preference
|
|
105
|
+
- Sentence structure patterns
|
|
106
|
+
- Metaphor usage
|
|
107
|
+
- Humor guidelines
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Live Products / Offerings
|
|
112
|
+
|
|
113
|
+
The project lists:
|
|
114
|
+
- Current offerings (products, services, projects, etc.)
|
|
115
|
+
- Status (active, development, archived)
|
|
116
|
+
- Key features or differentiators
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## Email Templates
|
|
121
|
+
|
|
122
|
+
Some projects use templated emails. Check overlay for:
|
|
123
|
+
- Email template library
|
|
124
|
+
- When to use canned vs custom
|
|
125
|
+
- Email formatting standards
|
|
126
|
+
- Signature blocks
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## Campaign Engine
|
|
131
|
+
|
|
132
|
+
Some projects have automated campaigns. Check overlay for:
|
|
133
|
+
- Campaign template system
|
|
134
|
+
- Variable injection patterns
|
|
135
|
+
- Segment-specific personalization
|
|
136
|
+
- Scheduling and delivery rules
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## Specialist Context — Read Project Overlay
|
|
141
|
+
|
|
142
|
+
Your task may require reading additional project-specific guides for:
|
|
143
|
+
- Complete acronym list
|
|
144
|
+
- Detailed financial facts
|
|
145
|
+
- Full audience segment profiles
|
|
146
|
+
- Campaign templates and examples
|
|
147
|
+
- Compliance and legal language requirements
|