h8rt3rmin8r h8rt3rmin8r

Project Technical Specifications

Project Name:
Version:
Status:
Last Updated:

This document is the authoritative, canonical source of truth for this project. All architectural, behavioral, and implementation decisions are governed by this specification. Sections may be left empty during early drafting, but headings and structure must remain intact.

A Practical Framework for AI-Driven Software Development

This framework formalizes a workflow that consistently produces clean, professional, and maintainable software when working with AI coding agents. It is designed to minimize hallucinations, scope drift, and “AI slop” while preserving velocity and creative leverage.

The core idea is simple: treat AI as a highly capable but short-term contractor that must be re-briefed from first principles at every meaningful phase of work.

Foundational Documents (Non-Negotiable)

Copilot Instructions

This document provides instructions for AI coding agents to effectively assist in developing the code within this project.

Standards for Writing Style and Tone

Always write in a way that reads as genuinely human and free from any linguistic patterns that commonly expose AI-generated text. Avoid all "AI tells," including but not limited to: excessive politeness, generic transitions (e.g., "Furthermore," "In conclusion," "Overall"), filler phrases ("It's important to note that"), parallel-sounding constructions ("not only...but also"), and overly balanced or neatly summarized conclusions.
Favor a natural flow that mirrors how an experienced writer or professional would actually communicate:
- Use sentence length variation (occasional fragments are fine).
Use contractions naturally ("I'm," "don't," "that's").

	#!/usr/bin/env bash

	# ==============================================================================
	# Script Name: install-docker.sh
	# Description: Production-ready Docker installation for Ubuntu Server.
	# Includes verification, verbosity, and fail-safe error handling.
	# Author: h8rt3rmin8r
	# ==============================================================================

	set -o pipefail # Fail if any command in a pipe fails

	<#
	.SYNOPSIS
	Generates a detailed JSON report of a directory tree structure.

	.DESCRIPTION
	Recursively analyzes a directory and creates a comprehensive JSON report containing:
	- Complete file/directory tree with metadata
	- Size metrics (bytes, words, lines)
	- Timestamps in both Unix and human-readable formats
	- Summary statistics including file extensions and depth analysis

	<#
	.SYNOPSIS
	Robust Animated GIF Converter (Hybrid Engine).
	Combines ImageMagick (Quality), LibWebP (Rescue), and FFmpeg (Fallback).

	.DESCRIPTION
	This script converts various video and animation formats to high-quality GIFs.
	It employs a "Survival" strategy to handle corrupt files that normally crash standard converters.

	STRATEGY PRIORITY:

	<#
	.SYNOPSIS
	Converts a directory of icon images into a JSON dataset containing metadata, dimensions, and base64 strings.

	.DESCRIPTION
	This script iterates through a specified directory of image files. For each file, it generates a custom
	PSObject containing the filename, size, dimensions, and a data object with the Base64 string.
	The final result is exported to a JSON file.

	Requirements:

	#!/usr/bin/env bash

	# ==============================================================================
	# Script Name : tree-json.sh
	# Description : Wraps the 'tree' command to output a detailed JSON structure
	# of a directory, including hidden files and sizes.
	# Requirements : 'tree' must be installed.
	# ==============================================================================

	# ------------------------------------------------------------------------------

	<#
	.SYNOPSIS
	Generates a comprehensive JSON map of Unicode characters.

	.DESCRIPTION
	This script iterates through the Unicode range from 1 to 129791 (U+0001 to U+1FAFF).
	It outputs a JSON list of objects, each containing the character's hex value,
	category, multi-language escape sequences (PS, Bash, Python), bit-depth, and a safety flag.

	It handles:

	<#
	.SYNOPSIS
	Launches a Chrome window to view a specified file, directory, or URL.
	.DESCRIPTION
	This script launches a Chrome window to view a specified file, directory, or
	Internet URL. Additional inputs can be provided to customize the size and
	position of the window.
	.PARAMETER Interactive
	If set, the script will prompt the user to select a file, directory, or URL
	using a graphical interface. This parameter is mutually exclusive with the