Kjell Tore Guttormsen
f460814fe9
Pre-trekexecute snapshot of in-progress CLAUDE.md/SKILL.md edits and extracted docs/ files. Captured as one commit so /trekexecute claude-design can run against a clean working tree. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
92 lines
3.2 KiB
Markdown
92 lines
3.2 KiB
Markdown
# ms-ai-architect — Development
|
|
|
|
Plugin development, testing, KB-refresh. Imported from `CLAUDE.md` via pointer.
|
|
|
|
## Legge til ny kunnskapsbase
|
|
1. Opprett `.md`-fil i riktig undermappe under den relevante skillens `references/`-mappe (f.eks. `skills/ms-ai-engineering/references/`)
|
|
2. Følg format fra eksisterende filer (header, dato, seksjoner, "For Cosmo"-seksjon)
|
|
3. Oppdater relevant SKILL.md med referanse
|
|
|
|
## Legge til ny kommando
|
|
1. Opprett `commands/navn.md` med frontmatter (`description`, `argument-hint`)
|
|
2. Følg mønster fra eksisterende kommandoer
|
|
3. Oppdater `commands/help.md` med ny kommando
|
|
4. Oppdater `CLAUDE.md`
|
|
|
|
## Legge til ny agent
|
|
1. Opprett `agents/navn-agent.md` med frontmatter (`name`, `description`, `model`, `color`, `tools`)
|
|
2. Inkluder tydelig "triggers on" i description
|
|
3. Oppdater `CLAUDE.md`
|
|
|
|
## Testing
|
|
|
|
### Statisk validering
|
|
```bash
|
|
# Kjør plugin-validering (frontmatter, encoding, KB-referanser)
|
|
bash tests/validate-plugin.sh
|
|
```
|
|
|
|
### KB-ferskhet (sitemap-basert, manuell drift)
|
|
|
|
**Apply-fasen kjøres via slash-kommandoen** (krever aktiv Claude Code-sesjon, holder oss innenfor Anthropic Consumer Terms § 3):
|
|
|
|
```text
|
|
/architect:kb-update # default: critical + high
|
|
/architect:kb-update --priorities critical # bare critical
|
|
/architect:kb-update --skip-discover # hopp over new-URL discovery
|
|
/architect:kb-update --dry-run # rapport uten apply
|
|
```
|
|
|
|
**Endringsrapport-fasen kan kjøres som rent Node-script (ingen LLM-kostnad):**
|
|
|
|
```bash
|
|
# Poll sitemaps → endringsrapport (ingen filendringer)
|
|
node scripts/kb-update/run-weekly-update.mjs --force
|
|
|
|
# Med discovery av nye relevante sider
|
|
node scripts/kb-update/run-weekly-update.mjs --force --discover
|
|
|
|
# Vis rapport på nytt etter polling
|
|
node scripts/kb-update/report-changes.mjs
|
|
|
|
# Bygg/oppdater URL-registry fra referansefiler
|
|
node scripts/kb-update/build-registry.mjs [--merge]
|
|
```
|
|
|
|
Systemet sammenligner Microsoft Learn sitemap-`<lastmod>` med filenes `Last updated:` header, og genererer en prioritert endringsrapport (critical/high/medium/low).
|
|
|
|
**Match rate:** ~69% av 1342 URLer matche mot sitemaps. ~31% (mest `azure/ai-foundry/openai/`-stier) finnes ikke i sitemaps pga. Microsofts URL-restrukturering.
|
|
|
|
**Schedulering:** Pluginen schedulerer ingenting. Bruker som vil ha periodisk varsling kan sette opp egen cron / launchd / systemd / GitHub Actions som kjører `node scripts/kb-update/run-weekly-update.mjs --force --discover` (rapport-fasen, ikke apply). Apply-fasen er bevisst manuell — den krever LLM-resonnering på diff og kjører fra en åpen Claude Code-sesjon.
|
|
|
|
Legacy (deprecated):
|
|
```bash
|
|
bash scripts/kb-staleness-check.sh # mtime-basert, upålitelig etter git clone
|
|
```
|
|
|
|
### E2E-regresjonstester
|
|
```bash
|
|
# Kjør alle E2E-suiter
|
|
bash tests/run-e2e.sh
|
|
|
|
# Kjør enkeltsuiter
|
|
bash tests/run-e2e.sh --security
|
|
bash tests/run-e2e.sh --cost
|
|
bash tests/run-e2e.sh --summary
|
|
bash tests/run-e2e.sh --ai-act
|
|
```
|
|
|
|
Fixture-basert validering av agent-output (sikkerhet, kostnad, sammendrag). Tester struktur, encoding, og domene-spesifikke krav uten å invokere Claude.
|
|
|
|
### Manuell test
|
|
```bash
|
|
# Test at plugin registreres
|
|
cd <plugin-root>
|
|
claude --plugin ./plugins/ms-ai-architect
|
|
|
|
# Kjør hovedcommand
|
|
/architect
|
|
|
|
# Vis alle kommandoer
|
|
/architect:help
|
|
```
|