Releases: k1lgor/virtual-company
Releases · k1lgor/virtual-company
Release list
v1.5.0
Added
- Voice Directive: writing style guidelines + banned AI-slop words (delve, crucial, robust, etc.) to enforce professional agent output quality
- Completion Status Protocol: DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_CONTEXT status framework with hard evidence gates — prevents vague "it's done" claims
- Confusion Protocol: STOP-and-ask guardrail for high-stakes ambiguity (architecture decisions, data model changes, destructive scope) — agents no longer guess on critical decisions
- Proactive Skill Routing: 28 intent-to-skill auto-dispatch mappings — users no longer need to memorize all 27 skill names; say "bug" →
bug-hunter, "deploy" →qa-engineer+code-reviewer - AskUserQuestion Decision Brief: structured user question format with D headers, ELI10 explanations, completeness scores, and forced recommendation — replaces ad-hoc agent questions
- AI Effort Compression Reference: human-vs-AI time comparison table (100x boilerplate, 30x features, 5x architecture) to reframe build-vs-skip scope decisions
- Learning Log (
scripts/log-learning.sh+ CLAUDE.md Operational Self-Improvement section): cross-session knowledge compounding — skills log durable project quirks, fixes, and patterns to~/.virtual-company/projects/<slug>/learnings.jsonl; loaded at session start - Preamble Tier System (T1-T4):
preamble-tierfield in all 27 SKILL.md frontmatters — controls which guardrail sections are active (T1=minimal documentation, T4=full security gates) to save tokens on simple skills while applying full discipline to critical ones - Skill Template Pipeline (
scripts/gen-skills.sh+skills/_templates/directory): SKILL.md.tmpl master template with{{PLACEHOLDER}}tokens resolved by 6 reusable resolver components (voice, completion, confusion, ask-user-format, effort-table, learning-log) — edit one resolver file to propagate changes to ALL skills; bug-hunter has a working.specproof of concept
Changed
- CLAUDE.md expanded from 346 to ~530 lines with 8 new operational sections inspired by gstack v1.58 architecture patterns
- All 27 SKILL.md files:
preamble-tierfield added to frontmatter (4x T1, 16x T2, 5x T3, 2x T4) - All internal references changed from
~/.gstack/to~/.virtual-company/(learning log storage, script paths) validate-skill.sh: now checks forpreamble-tierfield in SKILL.md filesscripts/README.md: documentedlog-learning.shandgen-skills.shscriptshooks.json: welcome banner bumped to v1.5.0.claude-plugin/plugin.json: v1.4.2 → v1.5.0, updated description with new features- New directories:
skills/_templates/(master template + 6 resolvers) - New files:
skills/_templates/SKILL.md.tmpl, 6 resolver.mdfiles,scripts/gen-skills.sh,scripts/log-learning.sh - All 27 skills now have
SKILL.md.specsource files generated from clean SKILL.md content + resolver placeholders - All 27 SKILL.md files regenerated via
gen-skills.sh --allwith Voice, Completion, Confusion, and Learning Log injected from resolvers (+68 lines per skill)
v1.4.2
Fixed
disallowedToolscorrected from bare YAML string to proper list[Edit, Bash]in all 5 advisory agents — previously the string literal was not parsed as a list, leaving agents potentially unrestrictedtech-leadagent now has explicitdisallowedTools: []— was the only agent missing this field entirelyqa-engineeragent now allowsBash(required to run test suites); onlyEditremains blockedvalidate-skill.shcalls incommands/skills.mdfixed — script expects a single file path, not a directory--category architectureexample corrected to valid category (logic)- PostToolUse lint hook now tries
npm,bun,yarn, andpnpm(wasbun-only)
Added
SessionEndhook — teardown message on session endPostCompacthook — context-resume prompt after compactionPreToolUseandPreCompacthooks now documented inCLAUDE.md(were present inhooks.jsonbut invisible to agents)commands/directory added toCLAUDE.mdTechnical Architecture section
Changed
- Architect agent: replaced
00-tech-leadskill with01-doc-writer— architect produces ADRs and delegates to tech-lead - Skills lists standardized to inline
[a, b, c]format across all agents - Code-reviewer effort tuned from
hightomedium(matches focused 10-turn audit role)
v1.4.1
Added
- Examples section added to
19-observability-specialistSKILL.md (structured logging, Prometheus/Grafana, OpenTelemetry tracing, alert rules)
Fixed
- Stale references to deleted scripts (
doc-health.sh,tsv-log.sh,dockerfile-lint.sh) in README.md, commands/skills.md, and skills/01-doc-writer/SKILL.md - PostToolUse lint hook now gracefully skips when no linter is configured (instead of erroring)
Changed
- Agent frontmatter:
qa-engineeradded missingdisallowedTools(Edit, Bash), fixedmaxTurnsspacing - Agent frontmatter:
tech-leadfixedmaxTurnsspacing docs/directory now tracked in git (was gitignored);.pantheon/added to.gitignore
v1.4.0
Added
performance-profileradded to Domain Expert Registry in Infrastructure category (was missing from CLAUDE.md, README, and commands/skills.md — table listed 26 but 27 skills exist)- Examples section added to
00-tech-leadSKILL.md (now 10/10 validation score) docs/plans/directory created (referenced throughout documentation and agents but didn't exist)
Fixed
- Agent naming consistency: README used
reviewerinstead ofcode-reviewer, andsecurityinstead ofsecurity-reviewer— now matches actual agent files and CLAUDE.md - PreToolUse security hook in
hooks/hooks.jsonwas non-functional (grepped/dev/stdinwhich never received content) — replaced with workingprompt-type warning skill-generatorwas listed in two categories (Orchestration and Meta) incommands/skills.md— removed duplicate Meta category
Removed
.agent/directory with 59 legacy/non-advertised skills and placeholder hooks (already gitignored, now fully purged from disk)tsv-log.sh— autoresearch-specific logger, not core to virtual-companydockerfile-lint.sh— Docker-only tool, not general-purposedoc-health.sh— generic documentation checker, not central to multi-agent orchestration
Changed
- Verification scripts reduced from 8 to 5 (kept: validate-skill, security-sentinel, verify-gate, coverage-gate, audit-deps)
- Plugin description updated to reflect 5 verification scripts
- README project structure diagram now shows all actual directories (
commands/,scripts/,.claude-plugin/)
v1.3.1
Fixed
- Fixed hooks.json schema to use
PostToolUsecorrectly with required hooks arrays - Fixed README install instructions — clarified GitHub shorthand usage vs plugin name
- Fixed plugin.json repository field from object to string format
Changed
- Updated initialization message to v1.3.1
- Lint command changed to
bun run lint
v1.3.0
Added
- Mechanical overrides and agent directives for operational rules (Step 0 rule, phased execution, senior dev override, forced verification, sub-agent swarming, context decay awareness, file read budget, tool result blindness, edit integrity, no semantic search)
- Hard gates for: task completion, pre-commit, refactors, and file edits
- Hard gate enforcement section in CLAUDE.md
Changed
- Refactored all 27 skills with standardized mechanical directives and operational guidance
- Decision trees, failure modes, and red flags sections standardized across skills
v1.2.0
v1.1.0
Added
- Native plugin architecture (
plugin.json,marketplace.json) - Automated lifecycle hooks (
hooks.json) - 8 verification scripts (validate-skill, security-sentinel, verify-gate, tsv-log, coverage-gate, dockerfile-lint, audit-deps, doc-health)
Changed
- Upgraded from standalone skills to full Claude Code plugin format
- Skills moved to
./skills/directory with numbered prefixes - Agents moved to
./agents/directory
v1.0.0
Added
- Initial release
- 27 domain expert skills with Hard Gates, Iron Laws, Decision Trees, Failure Modes
- 6 strategic role agents (planner, architect, tech-lead, code-reviewer, security-reviewer, qa-engineer)
- Skills command (
/virtual-company:skills) for listing and filtering experts - CLAUDE.md with orchestration flow, decision trees, and failure modes
- MIT License