Add LLM-agnostic Docker and build analysis tools

[tenpercent]

Summary

This PR introduces utility tools for building, testing, and analyzing Composable Kernel. The tools are designed to be LLM-agnostic and can be used with any AI assistant or directly from the command line.

Tools Added

1. ck-docker - Docker Container Management

• Start/stop ROCm-enabled containers
• Build targets with CMake + Ninja
• Run tests with gtest filters
• Auto-detect GPU targets (gfx950, gfx942, etc.)
• Per-user, per-branch container naming to avoid conflicts

2. ck-build-analysis - Build Time Profiling

• Uses Clang's -ftime-trace for compilation analysis
• Aggregates statistics across multiple trace files
• Identifies template instantiation bottlenecks
• Generates detailed Markdown reports with:
  • Compilation phase breakdown
  • Top expensive instantiations
  • Template family analysis
  • Data-driven optimization recommendations
• Configurable granularity (1µs to 500µs)
• PEP 723 compliant Python script with auto-dependency management via uv

Key Features

• LLM-agnostic design - Works with any AI assistant
• Zero-configuration setup - Automatic dependency installation
• Comprehensive documentation - README files for all tools
• Security hardening - Input validation, no command injection
• Multi-file trace aggregation - Accurate build analysis
• Jinja2-based report generation - Customizable output

Directory Structure

script/tools/
├── README.md                          # Main overview
├── README_ck-docker.md                # ck-docker documentation
├── README_ck-build-analysis.md        # ck-build-analysis documentation
├── ck-docker                          # Docker orchestration script
├── ck-build-analysis                  # Build analysis orchestration
├── common.sh                          # Shared utilities
├── analyze_build_trace.py             # Python analyzer (PEP 723)
└── templates/
    └── build_analysis_report.md.jinja # Report template

Testing

Verified with:

script/tools/ck-build-analysis example_convnd_fwd_xdl_fp32

Successfully analyzed 39,907 events across 4 files and generated a comprehensive build time report.

Usage

Terminal:

export PATH="$PATH:$PWD/script/tools"
ck-docker start
ck-docker build test_amdgcn_mma
ck-build-analysis example_convnd_fwd_xdl_fp32

With LLM Assistant:
Just ask in natural language:

• "Start the docker container"
• "Build and test test_amdgcn_mma"
• "Analyze build time for example_convnd_fwd_xdl_fp32"