Releases: systemowiec/ai-agents-workspace-starter
Releases · systemowiec/ai-agents-workspace-starter
Release list
v0.3.1 - Specialist Roles (UX, Performance, Security)
Added
- 3 new roles:
ux-engineer,performance-engineer,security-engineer - 3 new audit skills:
ux-audit(WCAG checklist),performance-audit(frontend+backend profiling),security-audit(OWASP-based vulnerability scan) - 3 new activation workflows:
as-ux-engineer,as-performance-engineer,as-security-engineer - AGENTS.md: 3 delegation hints for cross-role handoffs (security, performance, UX)
Changed
- AGENTS.md roles table expanded from 8 to 11 roles
Removed
- Root-level monolithic agent prompts (
design.md,performance.md,security.md) - content decomposed into roles, skills, and workflows
v0.3.0 - DT to Spec rename, layer-prefixed structure
[0.3.0] - 2026-03-20
Added
- New specification directory structure
docs/specs/with 6 layer subdirectories (arch, backend, frontend, infra, ai, e2e) - Layer-prefixed numbering:
ARCH-NNN,BE-NNN,FE-NNN,INFRA-NNN,AI-NNN,E2E-NNN - New
spec-lifecycle.mdreplacingdt-lifecycle.md - New templates:
_spec.md,_spec-report.md - Context templates moved to
docs/templates/:_project-overview.md,_api-map.md,_model-relationships.md - New graphical header image (PNG) replacing versioned SVG headers
infra/README.md: addedlogs/directory for IDE-accessible container logs with bind mount examplelearnings/patterns.mdfor reusable patterns discovered during work.gitignoreentries forinfra/logs/andinfra/storage/
Changed
- BREAKING: Renamed "Technical Document (DT)" to "Specification (Spec)" across entire project (~55 files)
- BREAKING: Renamed 4 workflows:
dt-development->spec-development,dt-report->spec-report,create-dt->create-spec,complete-dt->complete-spec - BREAKING:
docs/dt/directory replaced withdocs/specs/{layer}/{PREFIX}-NNN/ - All directory READMEs (frontend, backend, infra, e2e): changed "Expected structure" to "Suggested structure" with flexibility notes
- Simplified
.agents/context/README.md- removed template file entries - Updated all roles, workflows, skills, IDE configs (Claude, Cursor, Codex) with new spec terminology
Removed
docs/dt/directory anddocs/dt-lifecycle.mddocs/agent-reports/directorydocs/assets/header-dark.svganddocs/assets/header-light.svg(version-embedded)docs/templates/_dt.mdanddocs/templates/_dt-report.md- Template context files from
.agents/context/(moved todocs/templates/) - Polish comments in
.gitignore
v0.2.0 - Token optimization, new skills, agent patterns
[0.2.0] - 2026-03-20
Added
- New skill
agent-patterns- MCP Server, A2A Agent, Orchestrator, Shared Contracts templates - New skill
agent-testing- testing strategies for MCP, A2A, pipeline, and contract tests - New skill
python-standards- enterprise Python coding standards (Principal/Staff level) - New rule
agent-rules- 13 hard rules for multi-agent systems (MCP + A2A) - New rule
security- secrets, input validation, prompt security, Docker security, auth - New context template
mcp-sdk- MCP Python SDK quick reference - New context template
a2a-sdk- A2A Python SDK quick reference - New template
_scope.md- scope delegation template for architect-to-engineer handoffs - Quality Gate: Pre-Review Gate (5 automated tool checks before code review)
- Quality Gate: Metrics Thresholds table (file/function/params/nesting/cyclomatic/imports)
- Quality Gate: Named Anti-Patterns catalog (Fat Router, God Service, Leaking Layers, etc.)
- Backend patterns: Layer Prohibitions table (explicit MUST NOT per layer)
- Backend patterns: Router size limits and 5 explicit NEVER rules
- Python standards: naming anti-patterns (forbidden generic names, builtin shadows)
Changed
- AGENTS.md reduced from 310 to 213 lines (-31%) via Discovery Guide pattern
- All 17 skills: code blocks replaced with concise text rules (token optimization)
- All 8 roles: streamlined descriptions, removed redundant content
- All 15 workflows: self-improvement blocks replaced with cross-links
rules/global.mdreduced from 95 to 22 lines (redirects to AGENTS.md)dt-lifecycle.mdreorganized with clearer status flow- DT templates updated to
docs/dt/DT-NNN/directory structure CONTRIBUTING.mdupdated repo names and PL/EN relationship (independent versions)context/README.mdupdated with new MCP and A2A SDK referencesskills/README.mdupdated section reference to Discovery Guide
Removed
docs/agent-reports/README.md(merged into DT directory structure)- Approximately 900 lines of redundant code blocks across skills and roles
- Self-improvement boilerplate duplicated across workflow files
Fixed
- 7 critical inconsistencies (DT paths, dead links, status naming)
- Cross-links between roles, skills, and workflows verified and corrected