◆ CIC Recommendation Engine

Continuous Improvement Cycle — Powered by MyVillageProject

The CIC Recommendation Engine ingests developer check-in logs, maps skill progression across domains, routes data through AI agents for growth pattern analysis, and generates tailored next-step recommendations.

Brand Palette

| Color | Hex | Usage | | ----------- | --------- | ------------------------------ | | Gold | #B07C00 | Primary accent, headings | | Deep Green | #043922 | Brand frames, structure | | White | #FFFFFF | Primary text | | Cream | #E4DCCB | Secondary text, descriptions | | Teal | #799C9F | Commands, info labels | | Dark Brown | #302017 | Grounding elements |

Architecture

Check-in Logs → Skill Mapping → AI Growth Analysis → Recommendation

Core capabilities:

• Skill progression tracking across build domains
• Cumulative activity aggregation from check-in history
• AI-driven growth pattern recognition
• Personalized next-step recommendation generation
• Leverage point and skill gap identification

Prerequisites

• Node.js v18+
• npm

Setup

cd students_cli
npm install

Global install (optional)

npm install -g .

Registers the cic command system-wide.

Command Reference

| Command | Description | | ------------------------------------ | -------------------------------------------- | | cic recommend <first> <last> | Generate a recommendation for a developer | | cic recommend | Interactive mode (prompts for identity) | | cic --help | Display command reference | | cic --version | Print engine version |

Usage

Generate a recommendation

cic recommend Dequan Anderson

Interactive mode

cic recommend

  ╔═══════════════════════════════════════════════════════╗
  ║  ◆  C I C   R E C O M M E N D A T I O N   E N G I N E  ║
  ║      Powered by MyVillageProject                        ║
  ╚═══════════════════════════════════════════════════════╝

  First name: _
  Last name:  _

With npm (no global install)

npm start
node bin/cic.js recommend Dequan Anderson

How It Works

1. Ingest — Collects check-in logs and activity data for the target developer.
2. Map — Builds a cumulative skill progression index across tracked domains.
3. Analyze — Routes the progression map through AI agents for growth pattern detection.
4. Recommend — Returns a personalized recommendation with leverage points and next steps.

Project Structure

students_cli/
├── bin/
│   └── cic.js          # CLI entry point + command router
├── package.json
└── README.MD

Dependencies

| Package | Role | | --------------- | --------------------------------- | | axios | HTTP layer for endpoint requests | | chalk | Brand-colored terminal output | | ora | Process state indicators | | readline-sync | Interactive input capture |

Troubleshooting

| Issue | Resolution | | -------------------------------- | --------------------------------------------------------------------------------- | | 404 — webhook not registered | The recommendation engine endpoint must be active. Execute the workflow first. | | Connection timeout | Verify network connectivity and endpoint availability. | | Empty result | Identity may not match indexed records. Verify spelling. |

License

ISC