Skip to content

feat: Documentation Updates for Persona Distribution #435

@katriendg

Description

@katriendg

Parent: #431

Issue Description

Update documentation to reflect the persona-based distribution model. Create per-collection descriptions and update contributing guidelines for persona tagging.

Motivation

Documentation must explain how to tag new artifacts, how collections work, and what each persona package contains. Contributors need clear guidance to maintain persona assignments as new artifacts are added.

Deliverables

1. Contributing Documentation Updates

Update docs/contributing/ files:

  • custom-agents.md - Add guidance on selecting persona tags when creating agents
  • instructions.md - Add persona tagging guidance for new instructions
  • prompts.md - Add persona tagging guidance for new prompts
  • skills.md - Add persona tagging guidance for new skills
  • ai-artifacts-common.md - Add section on the artifact registry, persona taxonomy, and dependency declarations

2. Architecture Documentation Updates

Update docs/architecture/:

  • ai-artifacts.md - Document the registry design, persona model, and collection build system
  • Add collection/persona architecture section

3. Per-Collection Descriptions

Create description content for each collection package:

  • Full collection README content
  • Developer collection README content
  • TPM collection README content
  • DevOps collection README content
  • Architect collection README content
  • Technical Writer collection README content
  • Used in Marketplace listing and extension README

4. Getting Started Updates

Update docs/getting-started/:

  • install.md - Document persona selection during installation
  • Method-specific docs - Note which methods support persona filtering

5. Extension Packaging Documentation

Update extension/PACKAGING.md:

  • Document how to build persona-specific collection packages locally
  • Inner developer loop: testing collection manifests and registry filtering
  • Commands to build and validate individual collections (e.g., -Collection developer)
  • How to verify artifact inclusion/exclusion for a collection
  • Troubleshooting collection build issues

Acceptance Criteria

  • Contributing docs explain persona tagging for each artifact type
  • Architecture docs describe the registry design and collection model
  • Each collection has a description suitable for Marketplace listing
  • Getting started docs reflect the persona selection experience
  • Persona taxonomy is documented consistently (developer, tpm, devops, architect, technical-writer)
  • PACKAGING.md documents local testing workflow for collection builds

Additional Context

  • Existing contributing docs: docs/contributing/
  • Existing architecture docs: docs/architecture/
  • Depends on: feat: AI Artifacts Registry Design and Schema #432 (Phase 1: Registry Design and Schema)
  • Artifact categorization content comes from: Phase 6 (Persona-to-Artifact Mapping)

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationfeatureNew feature triggering minor version bump

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions