Add Makefile targets for Astro docs build and update technical-doc-writer agent

[Copilot]

Adds make build-docs and related targets for building/testing Astro documentation. Updates technical-doc-writer agent to build docs and fix issues before returning results.

Changes

Makefile targets:

• deps-docs - Install Astro dependencies
• build-docs - Build documentation to docs/dist
• dev-docs - Start dev server at http://localhost:4321
• preview-docs - Preview production build
• clean-docs - Remove build artifacts
• Updated clean target to remove docs artifacts
• Updated help with new targets

Technical-doc-writer agent (.github/agents/technical-doc-writer.agent.md):

• Added "Build and Validation Workflow" requiring make build-docs before completion
• Added troubleshooting guide for link validation, frontmatter, markdown syntax errors
• Lists available commands and dev server usage

Technical-doc-writer workflow (.github/workflows/technical-doc-writer.md):

• Added available commands section
• Added build verification requirements before PR creation
• Updated review process to rebuild after changes

Usage

# Build documentation
make build-docs

# Start dev server for live preview
make dev-docs

# Clean artifacts
make clean-docs

The agent now verifies documentation builds successfully and fixes errors before completing work.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• telemetry.astro.build
  • Triggering command: /opt/hostedtoolcache/node/24.12.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)
  • Triggering command: /opt/hostedtoolcache/node/24.12.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build gh api ithub-script/git/ref/tags/v8 --jq /usr/bin/gh om/astral-sh/setsh infocmp /usr/bin/git gh api /ref/tags/v8 --jq ache/node/24.12.0/x64/bin/node ithub-script/gitsh infocmp /usr/bin/git gh (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Add makefile target to build the Astro docs and update the technical documentation writer agent.md to build the docs and fix issues before retuning to the user

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.