skills.rest
zpyoung
zpyoungCOMMUNITY
Explore all skills by this author →
GitHub

typed-artifacts

Route project observations to structured artifact files and ADRs.

4|2|Updated May 4, 2026
Search Tags:#project management#task management#document management#bug tracking#architecture decision records
One-click install
npx skills add https://github.com/zpyoung/quirk --skill typed-artifacts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: typed-artifacts
Source: https://github.com/zpyoung/quirk/tree/main/skills/typed-artifacts
Command: npx skills add https://github.com/zpyoung/quirk --skill typed-artifacts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps manage and track observations like 'pre-existing', 'out of scope', 'future work', etc., by routing them to structured artifacts (BUGS.md, DEFERRED.md, TEST_BACKLOG.md, proposals.md) or Architecture Decision Records (ADRs).

Core Features & Use Cases

  • Observation Routing: Directly route observations to the appropriate artifact file.
  • Slash Commands: Use commands like /quirk:artifacts:bug to log a bug or /quirk:artifacts:defer to defer a task.
  • Review Cadences: Set up review schedules for different artifact files to maintain project organization.
  • Use Case: When working on a project, use this Skill to log a bug by running /quirk:artifacts:bug and provide details in the BUGS.md file.

Quick Start

Run /quirk:artifacts:init to scaffold artifact files into your project.

Frequently Asked Questions about typed-artifacts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage project observations like out of scope tasks and pre-existing bugs?▼

You can manage project observations by routing them directly to structured artifacts like BUGS.md or DEFERRED.md, enhancing documentation clarity and keeping project organization centralized.

How do I create an Architecture Decision Record for my software project?▼

You can create an Architecture Decision Record (ADR) by using specific slash commands to route your architectural observations, ensuring design choices are documented and tracked.

What is the best way to log a bug during software development?▼

The best way to log a bug is to use slash commands to route the issue directly into a BUGS.md file, capturing details and maintaining a structured project management workflow.

Can I set up review cadences for my project documentation and artifact files?▼

Yes, you can set up review schedules for different artifact files like TEST_BACKLOG.md and proposals.md to maintain project organization and ensure documentation is regularly reviewed.

How do I scaffold artifact files into a new project for task management?▼

You can scaffold artifact files into your project by running an initialization slash command, which sets up the necessary structured documents for tracking tasks and bugs.

Related Skills

Explore More Software Engineering Skills→
salemazielsalemaziel

project-conventions

Define project directory structures, file naming conventions, and working standards.

Community
Basic
pingmepipingmepi

pm-status

Aggregate PM-OS project stage statuses and activity logs from YAML and Markdown files.

Community
Basic
leha-creatorleha-creator

ai-factory.implement

Execute development tasks sequentially from a defined plan.

Community
Advanced
alangebalangeb

plan_template

Generate structured Markdown plan files with an 8-section template.

Community
Intermediate