architecture-mentor

Vibe Mentor

Public source repository for pragmatic mentoring skills that can be distributed to both Claude Code and OpenAI Codex.

What This Repo Provides

• One canonical, model-neutral architecture mentor skill
• A Claude Code marketplace wrapper
• A Codex plugin and marketplace wrapper
• Repo-scoped wrappers for local testing in both clients

The repository name is intentionally broader than the first skill. vibe-mentor is the umbrella distribution repo; architecture-mentor is the first concrete skill shipped from it.

The skill is aimed at:

• system architecture review
• trade-off analysis
• platform selection
• incident architecture and operational recovery shape
• enterprise and compliance constraints
• clarifying-question discipline
• pragmatic recommendations instead of generic best-practice sludge

Supported Clients

• Claude Code
• OpenAI Codex

Planning Docs

For ongoing multi-session design work, start with:

• docs/intent/vibe-mentor-intent.md
• docs/intent/skill-family-map.md
• docs/intent/session-sequence-guide.md

Repo Layout

content/
  architecture-mentor.md
  architecture-mentor-review.md
skills/
  architecture-mentor/
    SKILL.md
    agents/
      openai.yaml
.claude/
  skills/
    architecture-mentor/
      SKILL.md
.claude-plugin/
  marketplace.json
.agents/
  plugins/
    marketplace.json
  skills/
    architecture-mentor/
      SKILL.md
plugins/
  architecture-mentor/
    .claude-plugin/
      plugin.json
    .codex-plugin/
      plugin.json
    README.md
    skills/
      architecture-mentor/
        SKILL.md
scripts/
  bump_version.py
  install_git_hooks.sh
  validate_repo.py
  validate_versions.py
.githooks/
  pre-commit

Install From Git

Replace these placeholders with the real published repository path:

• GitHub Enterprise HTTPS URL: https://github.com/onetinov/vibe-mentor.git
• GitHub shorthand where supported: onetinov/vibe-mentor

Claude Code

Confirmed today

• Claude Code supports project and user skills from .claude/skills/ and ~/.claude/skills/.
• Anthropic's public plugin repos document plugin marketplace install commands:

claude plugin marketplace add anthropics/knowledge-work-plugins
claude plugin install sales@knowledge-work-plugins

Marketplace install

The public Anthropic examples confirm the command shape, but they do not fully document GitHub Enterprise URL variants. Start with the repo identifier if your Claude build accepts it, otherwise test the HTTPS URL form in your environment.

claude plugin marketplace add onetinov/vibe-mentor

If your Claude Code build accepts HTTPS Git URLs for plugin marketplaces, the intended equivalent is:

claude plugin marketplace add https://github.com/onetinov/vibe-mentor.git

Then install the plugin:

claude plugin install architecture-mentor@vibe-mentor

Project-scoped use

Confirmed project-scoped support exists for raw skills checked into the repo:

• ./.claude/skills/architecture-mentor/

This is useful when you want the skill available only inside one repository. Today, a one-command remote project-scoped plugin install path is not yet verified in the official Claude docs we checked.

User/global use

Confirmed user-scoped support exists for:

• ~/.claude/skills/

Marketplace-installed plugins appear to behave like user-level installs, but Anthropic's docs are less explicit than Codex's on exact install scope.

Enable, disable, uninstall

• Use claude plugin install ... to add the plugin
• Use Claude Code's plugin management UI or current claude plugin commands to disable or remove it
• For repo-scoped raw skills, remove or rename ./.claude/skills/architecture-mentor/

Codex

Confirmed today

Codex documents:

• repo-scoped skills in .agents/skills
• personal skills in $HOME/.agents/skills
• repo-scoped plugin marketplaces in $REPO_ROOT/.agents/plugins/marketplace.json
• personal marketplaces in ~/.agents/plugins/marketplace.json
• CLI marketplace commands via codex plugin marketplace ...

Marketplace install from HTTPS Git URL

This is the clearest documented install path for a remote public repo:

codex plugin marketplace add https://github.com/onetinov/vibe-mentor.git --sparse .agents/plugins

After that, browse or install the plugin from the Codex plugin directory.

Depending on your Codex build, a direct install command may also exist:

codex plugin add architecture-mentor@vibe-mentor

Treat that direct install command as version-sensitive unless your build documents it.

Project-scoped use

Confirmed project-scoped support exists in two forms:

1. Raw repo skill: ./.agents/skills/architecture-mentor/
2. Repo marketplace: ./.agents/plugins/marketplace.json plus ./plugins/architecture-mentor/

If you vendor this repo or copy these directories into your target repo, Codex can load the skill as project-local guidance.