platform-contextualizer

Document existing platform state and draft a baseline for Spec-Driven Development.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/javierhbr/random-poc --skill platform-contextualizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: platform-contextualizer
Source: https://github.com/javierhbr/random-poc/tree/main/custom-skills/sdd/platform-contextualizer-codex-skill
Command: npx skills add https://github.com/javierhbr/random-poc --skill platform-contextualizer

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of documenting and standardizing existing, often complex and undocumented, platform environments to prepare them for a structured Spec-Driven Development (SDD) workflow.

Core Features & Use Cases

  • Current State Documentation: Captures the existing platform's conventions, constraints, artifacts, and team interactions.
  • Gap Identification: Pinpoints inconsistencies, missing standards, and areas of drift.
  • Baseline Drafting: Creates a practical, durable platform baseline including principles, configuration, and role definitions.
  • Use Case: When onboarding a new team to an established platform, use this Skill to quickly understand and document the current operational landscape, identify areas needing standardization, and draft the foundational context for their work.

Quick Start

Use the platform-contextualizer skill to document the current state of the platform and identify gaps.

Frequently Asked Questions about platform-contextualizer

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

FAQPage Schema
How do I document an existing platform baseline for Spec-Driven Development?

To document a platform baseline for Spec-Driven Development, you need to capture the existing environment's conventions, constraints, artifacts, and team interactions. This process establishes explicit principles, reusable configuration, and role expectations for structured development phases.

What is the best way to identify gaps and standardization drift in a brownfield platform?

Identifying gaps in a brownfield platform requires analyzing current practices against desired outcomes to pinpoint inconsistencies and missing standards. This contextualization process highlights areas of drift and missing standards within active team workflows.

How do I onboard a new team to an established undocumented platform?

Onboarding a new team to an established platform involves quickly documenting the current operational landscape to understand existing conventions. Drafting a durable baseline with role definitions prepares the foundational context needed for their work.

Can I establish role expectations and reusable configuration for a brownfield environment?

Yes, you can establish role expectations and reusable configuration in a brownfield environment by analyzing current practices and artifacts. This analysis drafts a durable platform baseline that defines explicit principles for active teams.

Does platform contextualization work for environments with active teams and existing conventions?

Platform contextualization works specifically for brownfield environments with active teams and existing conventions. It focuses on capturing existing constraints and artifacts to prepare the established platform for structured development phases.