Skip to content

feat(signal): L99 architecture blueprint + LinkedIn Signal pack - #31

Draft
frankxai wants to merge 6 commits into
mainfrom
claude/creator-os-linkedin-epekb4
Draft

feat(signal): L99 architecture blueprint + LinkedIn Signal pack#31
frankxai wants to merge 6 commits into
mainfrom
claude/creator-os-linkedin-epekb4

Conversation

@frankxai

@frankxai frankxai commented Jul 8, 2026

Copy link
Copy Markdown
Owner

Summary

Ships the output of a 5-dimension / 11-agent architecture review of the ACOS agentic system, plus the first aligned build slice: the Signal LinkedIn Authority Engine. Core finding — the system is a beautifully-documented map that doesn't yet execute: the loop is open at both ends (nothing measured, nothing persists), which is the ceiling-capping constraint.

Change Type

  • New feature (non-breaking change that adds functionality)
  • Agent/Skill addition (new agent or skill for ACOS)
  • Documentation update

Frank DNA Alignment

  • Serves the mission — Signal helps a creator build their own compounding authority system, two-brand (personal + company)
  • Shows don't tells — the blueprint is an honest scorecard grounded in real files, not claims; the Signal pack drafts real output
  • Practical value — a usable /signal command surface today; a 90-day build sequence, not philosophy
  • Direct voice — technical, warm, understated throughout
  • No AI slop — the review explicitly flags (and this PR avoids) unmeasurable claims; enforces the Metrics-Truth rule

What's here

Docs (the thinking)

  • docs/architecture/L99_BLUEPRINT.md — verdict scorecard + delete/wire/measure plan.
  • docs/architecture/EXCELLENCE_LOOP.md — the canonical 8-step per-task loop + the Success Oracle keystone.

Signal pack (the proof case)

  • skills/signal/{SKILL,README,personas,knowledge}.md — two-brand voice model, hook taxonomy, format playbooks, Dream100 method.
  • .claude/commands/signal.md/signal plan|draft|repurpose|critique|ship|learn.
  • Registered in skills/registry.json.

For Structural Changes

Structural Change Checklist
  • Problem: ACOS generates content but doesn't measure or persist anything, so it can't compound — the premium promise. Evidence: empty/duplicated memory DBs, unwired hooks, in-memory social layer with // Simulate analytics.
  • Solution: additive only in this PR — docs + one new skill. The blueprint sequences the real fixes; nothing existing is restructured here.
  • Risk: low/reversible — new files, one registry entry. No routes, URLs, or config changed.
  • Frank Test: builds a system a creator owns · practical · proud to ship · ToS-safe by design (Signal drafts and stages; a human posts — no mode calls a posting endpoint; critique gates ship).

Testing

  • For agents/skills: validated YAML frontmatter on skills/signal/SKILL.md
  • skills/registry.json re-serialized via script (valid JSON, entry count 20 → 21)
  • Loop wiring (state spine, Typefully, Success Oracle) is scaffolded, not yet wired — tracked as Phases 0/3 in the blueprint

A companion shareable blueprint (the same content, designed) is available as a Claude artifact.


Generated by Claude Code

Adds the output of a 5-dimension / 11-agent architecture review of the
ACOS agentic system and the first aligned build slice.

Docs (the thinking):
- docs/architecture/L99_BLUEPRINT.md — honest scorecard + 90-day
  delete/wire/measure plan. Core finding: the loop is open at both ends
  (nothing measured, nothing persists) — the ceiling-capping constraint.
- docs/architecture/EXCELLENCE_LOOP.md — the canonical 8-step per-task
  loop + the Success Oracle keystone.

Signal pack (the proof case — LinkedIn Authority Engine):
- skills/signal/{SKILL,README,personas,knowledge}.md — two-brand voice
  model, hook taxonomy, format playbooks, Dream100 method.
- .claude/commands/signal.md — /signal plan|draft|repurpose|critique|ship|learn
- Registered in skills/registry.json.

ToS-safe by design: Signal drafts and stages; a human ships. No mode
calls a posting endpoint. Critique gates the publish boundary.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011saEKpfoKNC1JHMzAfBqmF
@coderabbitai

coderabbitai Bot commented Jul 8, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 709881ef-b734-4140-9456-a29bc2820e0c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/creator-os-linkedin-epekb4

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

The alignment-check CI requires YAML frontmatter on changed
.claude/commands/*.md files. Adds description + argument-hint to
match the convention used by 41 other command files.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011saEKpfoKNC1JHMzAfBqmF

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces the Signal pack, the LinkedIn vertical of the Agentic Creator OS (ACOS), along with core architectural specifications for the Excellence Loop and the L99 Blueprint. The changes include new command definitions, persona specs, and a knowledge base for Signal, alongside updates to the master skill registry. Feedback on these changes highlights several inconsistencies in skills/registry.json, including the use of an unregistered dependency (integrity-guard), an undefined category (marketing), and an inconsistent MCP reference (notion vs notion-mcp). Additionally, the trigger structure in SKILL.md should be aligned with the structured schema in the registry to support future automation.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread skills/registry.json
Comment on lines +712 to +715
"dependencies": [
"frankx-brand",
"integrity-guard"
],

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

The skill signal lists integrity-guard as a dependency. However, integrity-guard is not registered as a skill in this registry (skills/registry.json). All other dependencies in the registry refer to valid, registered skills.

If integrity-guard is a content verification mechanism/library rather than a standalone skill, it should not be listed in the dependencies array. If it is intended to be a skill, it must be registered in this file to prevent dependency resolution or CI validation failures.

      "dependencies": [
        "frankx-brand"
      ],

Comment thread skills/registry.json Outdated
},
"signal": {
"version": "0.1.0",
"category": "marketing",

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The skill signal is assigned the category marketing. However, marketing is not defined as a valid category in the categories object at the bottom of the registry file, nor is signal listed in any of the category arrays.

To maintain registry consistency, you should either:

  1. Add marketing as a new category in the categories object and list signal there.
  2. Change the category of signal to an existing one like creative (which aligns well with content strategy and multimodal studio) and add signal to the creative array.
Suggested change
"category": "marketing",
"category": "creative",

Comment thread skills/registry.json
Comment on lines +716 to +719
"mcp": [
"notion",
"firecrawl"
],

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

There is an inconsistency in how the Notion MCP server is referenced. The ops skill (line 676) references notion-mcp, whereas the signal skill references notion.

To ensure consistency across skills and correct resolution of MCP tools, please align the naming of the Notion MCP server to use the -mcp suffix.

Suggested change
"mcp": [
"notion",
"firecrawl"
],
"mcp": [
"notion-mcp",
"firecrawl"
],

Comment thread skills/signal/SKILL.md
Comment on lines +5 to +12
triggers:
- "/signal"
- "linkedin post"
- "linkedin article"
- "repurpose for linkedin"
- "linkedin week"
- "dream100"
- "thought leadership post"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The triggers in SKILL.md are defined as a flat list of strings. However, in skills/registry.json, the triggers for signal are structured into keywords, files, and commands.

Additionally, there are discrepancies between the two definitions:

  1. linkedin top voice is registered as a keyword in registry.json but is missing here.
  2. /signal is listed as a flat trigger here, but is registered under commands in registry.json.

If you plan to automate the generation of registry.json from skill frontmatter (as outlined in Phase 1 of the L99 Blueprint), the frontmatter trigger structure should be aligned with the registry schema.

Suggested change
triggers:
- "/signal"
- "linkedin post"
- "linkedin article"
- "repurpose for linkedin"
- "linkedin week"
- "dream100"
- "thought leadership post"
triggers:
keywords:
- "linkedin post"
- "linkedin article"
- "repurpose for linkedin"
- "linkedin week"
- "dream100"
- "thought leadership post"
- "linkedin top voice"
commands:
- "/signal"
files:
- "**/skills/signal/**"

claude added 4 commits July 8, 2026 17:10
integrity-guard is an agent (.claude/agents/integrity-guard.md), not a
registered skill, so it doesn't belong in the registry dependencies
array (skill deps only). The critique-gate relationship to the
integrity-guard agent stays documented in the SKILL prose. Resolves the
Gemini review comment on registry.json.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011saEKpfoKNC1JHMzAfBqmF
…word

Addresses the Gemini review on skills/registry.json + SKILL.md:
- category marketing -> creative (marketing was undefined; creative is the
  registry's content bucket) and add signal to the creative array.
- notion -> notion-mcp in both registry + SKILL.md, matching the ops skill.
- add the 'linkedin top voice' keyword to SKILL.md so its trigger vocab
  matches the registry.

SKILL.md triggers stay a flat list (every other SKILL.md uses that format);
full structured-trigger alignment is deferred to the Phase-1 frontmatter->
registry generator so all skills convert together, not one ahead of tooling.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011saEKpfoKNC1JHMzAfBqmF
…eam, /linkedin

Turns the Signal pack from spec into a runnable operating system:
- DAILY_LOOP.md — the ~45-min/day rhythm (ideate→draft→design→critique→
  ship→engage→learn) + weekly cadence + live-vs-needs-wiring table.
- research-sources.md — best-of-best intake lanes (papers/videos/pdfs/
  posts), the 3-point vetting bar, signal→post pipeline, content indexing.
- agent-team.md — the LinkedIn multi-agent org (lead + 6 workers + an
  independent critic), fan-out only where it pays.
- .claude/commands/linkedin.md — /linkedin router (memorable alias of
  /signal) with plan|research|draft|repurpose|carousel|infographic|
  critique|ship|engage|learn|index modes.
- docs/architecture/SIGNAL_ROADMAP.md — Stage 0 (operate now) → Stage 4
  (productize) road to Top Voice.
- SKILL.md — reconciled modes + operating-manual pointers.

Still ToS-safe: every mode drafts and stages; a human posts.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011saEKpfoKNC1JHMzAfBqmF
Signal's reference content (hook taxonomy, Dream100 method, format
playbooks) is genuinely good but was never wired end-to-end — DAILY_LOOP.md
already documents ship/learn as unbuilt. Consolidating that knowledge into
FrankX/.claude/skills/social-media-strategy/ so there's one live system
instead of two parallel, disconnected ones. This file stays as the ACOS
open-source reference version.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011saEKpfoKNC1JHMzAfBqmF
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants