Skip to content

AI Technical Writer

  • Hybrid
    • Grand Rapids, Michigan, United States
  • $37 - $41 per hour
  • Information Technology

Hybrid AI Technical Writer role requiring 5+ years in technical documentation, Docs-as-Code, Git, Markdown, taxonomy, governance, AI prompts, and structured engineering documentation.

Job description

Job Summary

We are seeking an experienced AI Technical Writer to develop and govern structured knowledge used by production AI agents. This role focuses on transforming engineering documentation, source code, configurations, standards, and technical knowledge into concise, structured content that AI systems can accurately retrieve and use. The ideal candidate has strong technical writing, information architecture, documentation governance, and Docs-as-Code experience.

Key Responsibilities

  • Create service overviews, runbooks, technical specifications, schemas, standards, and glossary documentation.

  • Develop concise summaries that improve AI knowledge retrieval.

  • Design taxonomies, metadata, indexes, cross-links, and structured documentation.

  • Apply metadata to organize content by domain, system, and AI use cases.

  • Author AI prompts, reusable skills, agent instructions, and supporting documentation.

  • Convert engineering, security, governance, and platform standards into version-controlled documentation.

  • Interview engineering teams to capture technical decisions and implementation details.

  • Manage documentation through governance, security, compliance, and approval workflows.

  • Maintain naming conventions, controlled vocabularies, and glossary definitions.

  • Review, update, archive, and retire outdated documentation.

  • Work within Git-based documentation workflows using pull requests and validation processes.

Job requirements

Required Qualifications

  • 5+ years of technical writing experience in software, infrastructure, platform engineering, or related technical environments.

  • 3+ years of document control, content governance, or controlled documentation experience.

  • Experience creating documentation from source code, configurations, specifications, and engineering runbooks.

  • Strong information architecture skills including taxonomy, metadata, indexing, and cross-linking.

  • Experience writing technical manuals, standards, reference documentation, and technical specifications.

  • Strong terminology management and vocabulary governance skills.

  • Experience collaborating with developers, engineers, architects, and governance teams.

  • Hands-on experience with Markdown, Git, version control, and Docs-as-Code workflows.

  • Excellent technical writing skills with the ability to write concise, structured documentation.

  • Must be able to work in a hybrid environment in Farmington Hills, MI.

Preferred Qualifications

  • Experience writing AI prompts, agent instructions, reusable AI skills, or LLM documentation.

  • Understanding of AI retrieval systems, context windows, and context management.

  • Experience with YAML, JSON frontmatter, schemas, and structured content.

  • Familiarity with AI orchestration, retrieval systems, or Model Context Protocol (MCP).

  • Experience with Git workflows, pull requests, CI validation, and CLI-based documentation.

  • Knowledge of ontologies, knowledge graphs, semantic models, or controlled vocabularies.

  • Basic understanding of Python, TypeScript, Terraform, or YAML.

  • Experience in regulated industries such as Banking, Financial Services, or Cybersecurity.

or