AI Software Engineer / Senior Technical Writer

Job Description

Job Description

ComResource is looking for a Senior Technical Writer.

Responsibilities:

• Author knowledge entries, including service overviews, runbooks, decision records, schemas, specifications, and glossary terms drawn from workflows, policies, engineering standards, and technical documentation.
• Write short descriptions and summaries that drive progressive disclosure, enabling AI agents to determine whether loading a full entry is worth the context cost.
• Structure orientation paths so an agent onboarding to an unfamiliar domain encounters the mental model, entry points, and invariants first, and drills into detail only on demand.
• Maintain hierarchy coherence across a growing catalog including cross-linking, indexing, reachability, and layered structure that keeps entries discoverable as the corpus scales.
• Own the scoping metadata that routes entries to the right consumer in the right context.
• Author and maintain prompt assets including reusable skills, agent instructions, and reference material consumed directly by production agents.
• Codify engineering standards by turning review standards, security requirements, and platform conventions into structured, versioned rules that automated code review agents apply on every pull request.
• Interview developers and engineers to capture the rationale behind decisions.
• Advance entries through review and approval with engineering and governance partners to ensure only verified content reaches production consumers.
• Govern vocabulary by maintaining the glossary and naming conventions and resolving terminology collisions before they propagate into schemas, tooling, and agent behavior.
• Keep the catalog current by identifying and retiring stale entries as the systems they describe change.

Essentials:

• 5–7 years of technical writing experience in software, platform, or infrastructure environments.
• Demonstrated ability to produce accurate technical content from primary sources including code, configuration, specifications, and runbooks with limited handholding.
• Strong information architecture instincts, including taxonomy, cross-linking, layered structure, and progressive disclosure.
• Experience authoring reference material, standards, or specification documentation consumed by engineers.
• Comfort working directly with developers and engineers, including the credibility to push back when source material is incomplete or contradictory.
• Experience partnering with governance, risk, security, or compliance stakeholders.
• Editorial discipline with consistency of terminology, voice, and structure maintained across many documents and contributors.
• Familiarity with docs-as-code practices including Markdown, version control, and content that lives in a repository alongside the systems it describes.
• Clear verbal communication skills with the ability to gather source material through conversation.
• Writes with precision under hard length constraints.
• Proficiency with Markdown, YAML, structured frontmatter, and schema validation.
• Familiarity with Git and pull-request workflows including documentation validation and link-checking tooling.

Desired:

• Hands-on experience writing prompts, agent instructions, or reusable skill definitions for LLM-based systems.
• Understanding of context management techniques for AI agents including progressive disclosure, context window economics, and retrieval strategy.
• Experience with structured content including YAML or JSON frontmatter validated against a schema, content models, or typed document formats.
• Working comfort with Git and CLI-based authoring workflows.
• Exposure to taxonomy design, ontologies, knowledge graphs, or controlled vocabularies.
• Background in developer documentation, API documentation, or internal platform documentation.
• Familiarity with AI agent concepts, including tool use, orchestration, retrieval, and agent context protocols such as MCP.
• Reading-level familiarity with Python, TypeScript, Terraform, or YAML-based configuration.
• Experience in banking, financial services, or another regulated industry.

Req ID: AM891999729