docs(ms-ai-architect): repo-standard-gate til 0 ERROR — Install/Non-goals/Changelog + doede lenker
Kjort mot repo-standard-skillen (klasse: plugin). Fire ERROR lukket: - README-DESC: aapningslinjen matcher naa forge-beskrivelsen ordrett (description == katalog == README paa en tredje flate) - HEADING-MISSING ## Install: install-blokka loeftet ut av «Quick Start» til fast ## Install paa foersteskjermen (begge CLI-linjer + settings.json som andre form); «### Prerequisites» → «### Requirements» under den - HEADING-MISSING ## Non-goals: ny seksjon — ikke juridisk raadgivning, deployer/provisjonerer ingenting, ikke live prisekilde, kun Microsoft- stacken, ikke et vendor-produkt, ikke tilknyttet Microsoft - HEADING-MISSING ## Changelog: «Version History» → ## Changelog med peker til CHANGELOG.md; tabellen beholdt Lenker: - licensing-matrix.md:608 pekte paa ../development/microsoft-agent-framework.md (finnes ikke) → ../development/agent-framework.md - README «Related Plugins» pekte paa ../llm-security — en relativ sti som kun virker i operatoerens lokale polyrepo-oppsett → forge-URL TOC oppdatert (15/15 ankere resolver). Gaten: 0 ERROR, 12 checks passed. Gjenstaaende WARN: H1 «AI Architect Plugin for Claude Code» != repo-navnet — bevisst tittel, beholdt (gaten kaller den eksplisitt operatoerens valg). Verifisert: repo-standard-check.mjs exit 0; tests/test-kb-integrity.sh 222/222. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UwWdSC4Syh9pYjLA9kxy98
This commit is contained in:
parent
a9d472488d
commit
0675d9a6dd
2 changed files with 47 additions and 31 deletions
76
README.md
76
README.md
|
|
@ -1,5 +1,7 @@
|
|||
# AI Architect Plugin for Claude Code
|
||||
|
||||
Microsoft AI Solution Architect — structured architecture guidance for the full Microsoft AI stack.
|
||||
|
||||
> Your virtual Microsoft AI solution architect — meet **Cosmo Skyberg**.
|
||||
|
||||
> **Solo-maintained, fork-and-own.** This plugin is a starting point, not a vendor product. Issues are welcome as signals; pull requests are not accepted. See [GOVERNANCE.md](GOVERNANCE.md) for the full model and what upstream provides.
|
||||
|
|
@ -14,12 +16,40 @@
|
|||
|
||||
A Claude Code plugin that provides structured architecture guidance across the full Microsoft AI stack. Cosmo Skyberg is a methodical, opinionated architect persona who understands the problem before recommending technology, verifies claims against live Microsoft Learn documentation via MCP, and delivers assessments calibrated for Norwegian public sector governance — while remaining useful for any enterprise context.
|
||||
|
||||
## Install
|
||||
|
||||
Both lines are required — the first adds the marketplace, the second installs this plugin from it:
|
||||
|
||||
```bash
|
||||
claude plugin marketplace add https://git.fromaitochitta.com/open/ktg-plugin-marketplace.git
|
||||
claude plugin install ms-ai-architect@ktg-plugin-marketplace
|
||||
```
|
||||
|
||||
To browse the other plugins in the marketplace instead, run `/plugin`.
|
||||
|
||||
Or enable directly in `~/.claude/settings.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"enabledPlugins": {
|
||||
"ms-ai-architect@ktg-plugin-marketplace": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Requirements
|
||||
|
||||
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
|
||||
- Python with [uv](https://github.com/astral-sh/uv) (for the microsoft-learn MCP server)
|
||||
- Network access to `learn.microsoft.com`
|
||||
|
||||
---
|
||||
|
||||
## Table of Contents
|
||||
|
||||
- [What Is This?](#what-is-this)
|
||||
- [Quick Start](#quick-start)
|
||||
- [Non-goals](#non-goals)
|
||||
- [First Conversation](#first-conversation)
|
||||
- [Commands](#commands)
|
||||
- [Agent Architecture](#agent-architecture)
|
||||
- [Knowledge Base](#knowledge-base)
|
||||
|
|
@ -30,7 +60,7 @@ A Claude Code plugin that provides structured architecture guidance across the f
|
|||
- [Technology Coverage](#technology-coverage)
|
||||
- [Enterprise Onboarding](#enterprise-onboarding)
|
||||
- [Related Plugins](#related-plugins)
|
||||
- [Version History](#version-history)
|
||||
- [Changelog](#changelog)
|
||||
- [License & Attribution](#license--attribution)
|
||||
|
||||
---
|
||||
|
|
@ -58,36 +88,20 @@ Key capabilities:
|
|||
|
||||
---
|
||||
|
||||
## Quick Start
|
||||
## Non-goals
|
||||
|
||||
### Prerequisites
|
||||
What this plugin deliberately does not do — worth knowing before you adopt it:
|
||||
|
||||
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
|
||||
- Python with [uv](https://github.com/astral-sh/uv) (for the microsoft-learn MCP server)
|
||||
- Network access to `learn.microsoft.com`
|
||||
- **It is not legal advice.** Classification, DPIA/PVK and ROS output is decision support for architects. It is drafted to be reviewed by your data protection officer, legal counsel and approving authority — not to replace them.
|
||||
- **It does not deploy or provision anything.** Every command produces a document or an assessment. No command creates, modifies or deletes Azure resources, and the plugin writes no infrastructure-as-code.
|
||||
- **It is not a live pricing source.** Cost estimates use published list prices with explicit disclaimers and P10/P50/P90 ranges. Verify against the Azure pricing calculator before committing a budget.
|
||||
- **It covers the Microsoft stack only.** AWS Bedrock, Google Vertex AI and direct-to-provider LLM APIs are out of scope, including comparisons against them.
|
||||
- **It is not a vendor product.** Solo-maintained, no SLA, pull requests are not accepted — see [GOVERNANCE.md](GOVERNANCE.md).
|
||||
- **It is not affiliated with Microsoft.** Product names are trademarks of Microsoft Corporation, and nothing here is endorsed by them.
|
||||
|
||||
### Installation
|
||||
---
|
||||
|
||||
Both lines are required — the first adds the marketplace, the second installs this plugin from it:
|
||||
|
||||
```bash
|
||||
claude plugin marketplace add https://git.fromaitochitta.com/open/ktg-plugin-marketplace.git
|
||||
claude plugin install ms-ai-architect@ktg-plugin-marketplace
|
||||
```
|
||||
|
||||
To browse the other plugins in the marketplace instead, run `/plugin`.
|
||||
|
||||
Or enable directly in `~/.claude/settings.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"enabledPlugins": {
|
||||
"ms-ai-architect@ktg-plugin-marketplace": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### First Conversation
|
||||
## First Conversation
|
||||
|
||||
```
|
||||
> /architect
|
||||
|
|
@ -554,7 +568,7 @@ For organizations that need deeper customization beyond what onboarding provides
|
|||
|
||||
### LLM Security Plugin
|
||||
|
||||
The **[LLM Security Plugin](../llm-security)** is a companion plugin that covers the agentic AI attack surface — the runtime security dimension that complements this plugin's architecture-level assessments.
|
||||
The **[LLM Security Plugin](https://git.fromaitochitta.com/open/llm-security)** is a companion plugin that covers the agentic AI attack surface — the runtime security dimension that complements this plugin's architecture-level assessments.
|
||||
|
||||
While **ms-ai-architect** evaluates *what to build* (platform selection, compliance, cost, risk), the LLM Security Plugin evaluates *whether what you built is safe to deploy* by scanning Claude Code plugins, MCP servers, and AI agent configurations against the OWASP LLM Top 10.
|
||||
|
||||
|
|
@ -658,7 +672,9 @@ Category-to-skill routing is defined in `scripts/kb-update/data/domain-taxonomy.
|
|||
|
||||
---
|
||||
|
||||
## Version History
|
||||
## Changelog
|
||||
|
||||
Full history, including patch releases: [CHANGELOG.md](CHANGELOG.md). The table below summarizes the minor releases.
|
||||
|
||||
| Version | Date | Highlights |
|
||||
|---------|------|-----------|
|
||||
|
|
|
|||
|
|
@ -605,7 +605,7 @@ Tilgjengelig som selvstendig add-on (~$15/bruker/måned, *community-kilde*); anb
|
|||
|
||||
- [Decision Trees](./decision-trees.md) — Når bruke hvilken plattform
|
||||
- [Security & Compliance](./security.md) — Sikkerhetskrav per lisens
|
||||
- [Microsoft Agent Framework](../development/microsoft-agent-framework.md) — Custom agent development
|
||||
- [Microsoft Agent Framework](../development/agent-framework.md) — Custom agent development
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue