C-Level Advisory System

AI-powered executive advisory for software projects. Point it at any local repository and get structured assessments from CTO, CPO, COO, CMO, CFO, and CSO perspectives — grounded in actual code signals and live competitive research.

What It Does

The system walks a repository, extracts structured signals (stack, docs, CI/CD, tests, dependencies, security), then runs six specialist analyses before synthesizing them into a prioritized executive brief.

[Repo] → Ingestion →  ┌─ CTO Analysis ─┐
                      ├─ CPO Analysis ─┤
                      ├─ COO Analysis ─┤ → Research → Synthesis → Report
                      ├─ CMO Analysis ─┤
                      ├─ CFO Analysis ─┤
                      └─ CSO Analysis ─┘

The analysis rubrics live in prompts/ and are model-agnostic markdown — they work with any AI assistant that can read files and follow instructions. Adapter-specific wiring is installed separately per tool.

Installation

npx @isonimus/c-level init

The CLI asks which AI assistant you use and scaffolds the right files into the current directory:

  C-Level Advisory System

  Which AI assistant do you use?

    1.  Claude Code  —  Full multi-phase pipeline with slash commands
    2.  Cursor  —  Agent rules via @rule-name in Cursor Chat

To install into a specific path or skip the prompt:

npx @isonimus/c-level init /path/to/my-project
npx @isonimus/c-level init --adapter claude-code
npx @isonimus/c-level init --adapter cursor

Prerequisites:

• The AI assistant of your choice (Claude Code or Cursor)
• Internet access required for competitive research (/research, @research)
• Target repository must be readable on the local filesystem

Usage by Adapter

Claude Code

Open Claude Code in the repo and use slash commands:

/assess /path/to/your/repo      # Full pipeline
/cto /path/to/your/repo        # CTO only
/cpo /path/to/your/repo        # CPO only
/coo /path/to/your/repo        # COO only
/cmo /path/to/your/repo        # CMO only
/cfo /path/to/your/repo        # CFO only
/cso /path/to/your/repo        # CSO only
/research <description>         # Competitive landscape
/ingest /path/to/your/repo     # Signal extraction only
/reports                        # List saved reports

Cursor

In Cursor Chat or Agent, reference rules by name:

@assess /path/to/your/repo
@cto /path/to/your/repo
@cpo /path/to/your/repo
@coo /path/to/your/repo
@cmo /path/to/your/repo
@cfo /path/to/your/repo
@cso /path/to/your/repo
@research <description>
@ingest /path/to/your/repo
@reports

Scoring

All assessments use a 1–10 scale:

| Range | Meaning | |---|---| | 1–3 | Critical issues. Significant rework needed before production-worthy. | | 4–6 | Functional but with substantial gaps. Needs focused investment. | | 7–8 | Good. Minor improvements and polish needed. | | 9–10 | Excellent. Industry-leading in this dimension. |

Output

Reports are saved to reports/<repo_name>_<YYYY-MM-DD>.md. The reports/ directory is git-ignored by default — reports often contain proprietary analysis of private codebases. To commit a report, force-add it with git add -f.

How It Works

1. Ingestion — walks the repo, extracts structured signals: stack, docs, CI, tests, deps, security
2. CTO — technical assessment: architecture, debt, scalability, build process
3. CPO — product assessment: clarity, onboarding, UX signals, feature gaps
4. COO — operational assessment: CI/CD maturity, observability, process hygiene
5. CMO — marketing assessment: brand, community, distribution, growth loops
6. CFO — financial assessment: cost structure, licensing risk, revenue readiness
7. CSO — security assessment: threat model, vulnerability surface, compliance readiness
8. Research — web search for competitive products, feature comparison, market positioning
9. Synthesis — rolls all findings into a prioritized executive brief

The synthesis weights each dimension: CTO 22% / CPO 22% / CMO 18% / COO 13% / CSO 10% / CFO 10% / Market 5%.

Prompt Library

All analysis logic lives in prompts/. These files are the core of the system — edit them to tune the rubrics for your context.

| File | Role | |---|---| | prompts/ingest.md | Repo signal extraction | | prompts/cto.md | CTO analysis rubric | | prompts/cpo.md | CPO analysis rubric | | prompts/coo.md | COO analysis rubric | | prompts/cmo.md | CMO analysis rubric | | prompts/cfo.md | CFO analysis rubric | | prompts/cso.md | CSO analysis rubric | | prompts/research.md | Competitive research instructions | | prompts/synthesize.md | Executive synthesis rubric |

Contributing

See CONTRIBUTING.md for how to improve rubrics, add new C-level perspectives, or build adapters for additional AI assistants.