/article

Quick-create an Article note for communications - blog posts, videos, podcasts, LinkedIn posts, etc.

Usage

/article <title>                              # Create draft article
/article <title> type <article-type>          # Specify format type
/article <title> for <platform>               # Specify target platform
/article <title> from <incubator-idea>        # Link to source incubator idea
/article list [filter]                        # List articles by status

Examples

/article Cloud Migration Lessons Learned
/article Event-Driven Architecture Benefits type blog-post for medium
/article Why We Chose Kafka type linkedin-post
/article API Versioning Best Practices from API Strategy Incubator
/article Integration Patterns type video for youtube

---

Create Article: /article <title> [options]

Fast capture with sensible defaults.

Article Types: article, blog-post, document, guardrail, video, podcast, linkedin-post Platforms: medium, substack, confluence, linkedin, youtube, spotify, internal

1. Parse command for:

   • title: Article title (required)
   • type: Article format (after "type") - default: article
   • platform: Target platform (after "for") - default: null
   • parentIdea: Incubator idea (after "from") - fuzzy match

2. Generate filename: Article - {{title}}.md

3. Create in vault root:

---
type: Article
title: {{title}}
created: {{DATE}}
modified: {{DATE}}
tags:
  - activity/documentation
  - {{domain tags based on title/context}}

# Article Classification
articleType: {{type or article}}
platform: {{platform or null}}
targetAudience: {{internal if confluence/internal, external if medium/substack/linkedin, null otherwise}}

# Provenance
parentIdea: {{incubator link or null}}

# Publication
status: draft
publishedUrl: null
publishedDate: null

# Quality Indicators
summary: null
confidence: medium
freshness: current
source: synthesis
verified: false
reviewed: {{DATE}}

# Semantic Discovery
keywords: []

# Relationships
relatedTo: []
---

# {{title}}

## Summary

<!-- One paragraph executive summary -->

## Key Points

-

## Content

<!-- Main article content -->

{{If from incubator: "Based on research from [[Incubator - {{idea}}]]"}}

## Call to Action

<!-- What should the reader do next? -->

## References

-

---

*Created with `/article` skill*

4. If parentIdea provided:

   • Fuzzy match incubator idea in +Incubator/ or +Archive/Incubator/
   • Format as wiki-link: "[[Incubator - API Strategy]]"
   • Add to Related section

5. Infer targetAudience from platform:

   • medium, substack, linkedin, youtube, spotify → external
   • confluence, internal → internal
   • null platform → null audience

6. Confirm: Created [[Article - {{title}}]] ({{articleType}} for {{platform or "unspecified platform"}})

---

List Articles: /article list [filter]

Filter by status, type, or platform.

Statuses: draft, ready, published, archived Types: article, blog-post, document, guardrail, video, podcast, linkedin-post Platforms: medium, substack, confluence, linkedin, youtube, spotify, internal

1. Read vault root for type: Article notes
2. Filter by provided criteria
3. Display as table:

Article	Type	Platform	Status	Modified

4. No filter = show count by status

---

Publish Article: /article publish <title>

Mark an article as published.

1. Fuzzy match article by title
2. Ask for published URL
3. Update frontmatter:
   • status: published
   • publishedUrl: {{url}}
   • publishedDate: {{DATE}}
4. Confirm: Marked [[Article - {{title}}]] as published

---

Article Type Reference

Type	Description	Typical Platforms
article	Long-form written content	confluence, internal
blog-post	External thought leadership	medium, substack
document	Formal whitepaper or standard	confluence, internal
guardrail	Technical guardrail or standard	confluence
video	Tutorial or presentation	youtube, internal
podcast	Audio discussion or interview	spotify, internal
linkedin-post	Professional network sharing	linkedin

---

Platform Reference

Platform	Type	Audience
medium	Blog	External
substack	Newsletter	External
confluence	Wiki	Internal
linkedin	Professional	External
youtube	Video	External
spotify	Podcast	External
internal	Internal channels	Internal

---

Integration with Incubator

Articles are a graduation outcome from the Incubator. When an idea is ready to become a communication piece:

1. Use /article <title> from <idea> to create the article
2. Use /incubator graduate <idea> to mark the idea as accepted
3. The idea's outcome field will link to the new article

Example workflow:

# Create article from incubated idea
/article Why Event-Driven Architecture from Event Patterns

# Graduate the incubator idea
incubator graduate Event Patterns
→ Sets outcome to [[Article - Why Event-Driven Architecture]]

---

Reference

• [[Page - Incubator Guide]] - Incubator graduation workflow
• [[.claude/rules/frontmatter-reference.md]] - Article schema