From plaited-plaited
SQLite-backed Plaited codebase search and context assembly. Use before implementing, reviewing, or updating docs to gather source-grounded files, symbols, patterns, tests, skills, and prior findings.
npx claudepluginhub joshuarweaver/cascade-code-general-misc-3 --plugin plaited-plaitedThis skill uses the workspace's default tool permissions.
`plaited-context` is a script-first operational context layer for Plaited. It
assets/queries/README.mdassets/schema.sqlscripts/context.tsscripts/export-review.tsscripts/git-context.shared.tsscripts/git-context.tsscripts/git-history.tsscripts/git-worktrees.tsscripts/init-db.tsscripts/module-flow.tsscripts/module-patterns.tsscripts/plaited-context.tsscripts/record-finding.tsscripts/scan.tsscripts/search.tsscripts/tests/git-context.spec.tsscripts/tests/module-flow.spec.tsscripts/tests/module-patterns.spec.tsscripts/tests/plaited-context.spec.tsscripts/tests/wiki-context.spec.tsApplies Acme Corporation brand guidelines including colors, fonts, layouts, and messaging to generated PowerPoint, Excel, and PDF documents.
Builds DCF models with sensitivity analysis, Monte Carlo simulations, and scenario planning for investment valuation and risk assessment.
Calculates profitability (ROE, margins), liquidity (current ratio), leverage, efficiency, and valuation (P/E, EV/EBITDA) ratios from financial statements in CSV, JSON, text, or Excel for investment analysis.
plaited-context is a script-first operational context layer for Plaited. It
indexes source files, AGENTS operational instructions, wiki/reference docs,
skills, and findings into SQLite so follow-on work starts from source-grounded
evidence instead of memory. It is also the canonical home for deterministic
module actor runtime analysis and module flow review evidence.
Use it before:
The scripts resolve runtime context into one of three modes:
repo: running inside the Plaited source repositorypackage: running from a node_modules/plaited installationworkspace: running from another workspace contextThe resolver reports:
type OperationalContext = {
mode: 'repo' | 'package' | 'workspace'
cwd: string
workspaceRoot: string
repoRoot?: string
packageRoot?: string
nodeHome?: string
dbPath: string
}
Override order for DB path:
dbPathPLAITED_CONTEXT_DB.plaited/context.sqlite under resolved workspace/node-homePLAITED_NODE_HOME is respected. Defaults never target writable paths inside
node_modules package files.
assets/ is static shipped material only (schema.sql, query templates)..plaited/context.sqlite.bun skills/plaited-context/scripts/init-db.ts '{"dbPath":".plaited/context.sqlite"}'
bun skills/plaited-context/scripts/scan.ts '{"rootDir":".","include":["AGENTS.md","src","skills","docs"],"force":false}'
bun skills/plaited-context/scripts/context.ts '{"task":"review module actor diagnostics","mode":"review","paths":["src/modules/example.ts"]}'
bun skills/plaited-context/scripts/wiki-context.ts '{"task":"review runtime module architecture","paths":["src/modules"],"limit":10}'
bun skills/plaited-context/scripts/search.ts '{"query":"useSnapshot reportSnapshot","limit":20}'
bun skills/plaited-context/scripts/module-patterns.ts '{"files":["src/modules/example.ts"]}'
bun skills/plaited-context/scripts/module-flow.ts '{"files":["src/modules/example.ts"],"format":"json"}'
bun skills/plaited-context/scripts/module-flow.ts '{"files":["src/modules/example.ts"],"format":"mermaid"}'
When flow evidence is sparse or alias-heavy, run TypeScript LSP probes:
bun skills/typescript-lsp/scripts/run.ts '{"file":"src/modules/example.ts","operations":[{"type":"symbols"}]}'
bun skills/typescript-lsp/scripts/run.ts '{"file":"src/modules/example.ts","operations":[{"type":"references","line":120,"character":8}]}'
bun skills/typescript-lsp/scripts/run.ts '{"file":"src/modules/example.ts","operations":[{"type":"definition","line":120,"character":8}]}'
bun skills/plaited-context/scripts/git-context.ts '{"base":"origin/dev","paths":["skills/plaited-context"],"includeWorktrees":true}'
bun skills/plaited-context/scripts/git-history.ts '{"base":"origin/dev","paths":["skills/plaited-context"],"limit":20}'
bun skills/plaited-context/scripts/git-worktrees.ts '{}'
bun skills/plaited-context/scripts/record-finding.ts '{"finding":{"kind":"anti-pattern","status":"candidate","summary":"Internal handlers should not catch ZodError locally.","evidence":[{"path":"src/modules/example.ts","line":100,"symbol":"server_start"}]}}'
bun skills/plaited-context/scripts/export-review.ts '{"status":["candidate","validated"],"format":"json"}'
Do not promote guesses into validated findings.
candidate findings may have optional evidence while being triaged.validated and retired findings must include evidence.When sources conflict, prioritize:
src/ and other executable sourcesAGENTS.md operational instructions by scopeskills/*/SKILL.md)AGENTS.md files are operational instructions, not wiki docs.
Wiki docs are searchable synthesis/reference material and do not outrank code,
AGENTS.md, or applicable skills.
Wiki cleanup candidates are review evidence only; they are not automatic rewrite actions.
Use scan.ts, search.ts, context.ts, and wiki-context.ts to assemble
context instead of manually reading broad docs trees.
Git context in this skill is read-only evidence for review and planning:
Git context augments code/test/skill/wiki context; it does not replace source
or test evidence and does not override AGENTS.md.
Git context commands in this skill do not authorize merge/rebase/reset/stash mutation, branch deletion, or worktree removal.
All scripts accept one JSON argument and print JSON output. They support schema introspection:
bun skills/plaited-context/scripts/<script>.ts --schema input
bun skills/plaited-context/scripts/<script>.ts --schema output
JSON exports are intended for PR and human review workflows.