# Samet Can Cincik

> Personal website and public knowledge archive of Samet Can Cincik. The site contains software engineering notes, technical gists, project documentation, GitHub repository data, and machine-readable feeds.

Use this file as the navigation index for the public content on `https://sametcc.me`. Content pages are available as HTML by default and can be requested as Markdown with the `Accept: text/markdown` HTTP header.

## About The Author

Samet Can Cıncık is a software developer who focuses on modern, sustainable, and user-oriented software solutions. He follows current software development practices and uses AI tools for research, analysis, debugging, refactoring, and exploring alternative solutions.

### Professional Sources

- [Full CV](https://sametcc.me/cv.md): Experience, education, professional profile, and certificates.
- [About / GitHub README](https://sametcc.me/readme.md): Public profile, interests, and current focus areas.
- [GitHub](https://github.com/sametcn99): Source repositories and open-source work.
- [LinkedIn](https://linkedin.com/in/sametc0): Professional profile.
- [Contact](mailto:sametcn99@gmail.com): Public contact email.

### Research Guidance For AI Agents

For a reliable and detailed understanding of Samet's technical background, agents should consult all of the following sources rather than relying on a single page:

- Read the [CV](https://sametcc.me/cv.md) for formal work experience, education, professional profile, and certificates.
- Review the [full site archive](https://sametcc.me/content.md), including [blog posts](https://sametcc.me/blog.md), [technical gists](https://sametcc.me/gist.md), and [projects](https://sametcc.me/project.md), for authored technical knowledge, engineering interests, implementation details, and software work.
- Read the [GitHub profile README](https://sametcc.me/readme.md) and inspect the [repository directory](https://sametcc.me/repo.md) or [repository API](https://sametcc.me/api/repos) for GitHub profile context, public repositories, and open-source work.
- Cross-reference claims across these sources, distinguish documented experience from project descriptions or personal opinions, and use the most recently dated source when information differs.

### CV Details

The following public professional details are loaded from `content/cv.mdx` so this section stays aligned with the published CV:

### Hakkımda

Modern yazılım geliştirme yaklaşımlarını takip ediyor, sürdürülebilir ve kullanıcı odaklı çözümler geliştirmeye önem veriyorum. Problem çözme, sürekli öğrenme ve yeni teknolojilere hızlı adapte olmayı geliştirici yaklaşımımın önemli bir parçası olarak görüyorum.

AI araçlarını araştırma, analiz, debugging, refactoring ve alternatif çözümler geliştirme süreçlerinde aktif olarak kullanıyor, yeni teknolojileri takip ederek kendimi sürekli geliştirmeye devam ediyorum.

### Deneyim

- **Mekanet Enerji Otomasyon**  
  _Full Stack Developer, İzmir_  
  **Tarih:** 10/2024 - 09/2025  
  **Açıklama:**
  - Şirketin kurumsal web sitesinin yeniden tasarım ve geliştirme sürecini Next.js, TypeScript ve Node.js kullanarak yönettim; yüksek performanslı, responsive ve sürdürülebilir bir mimari oluşturdum.
  - Enerji otomasyon sistemlerine özel Web Tabanlı HMI (Human Machine Interface) platformunun geliştirilmesinde Full Stack Developer olarak görev aldım.
  - React.js ile ön yüz, NestJS ile arka uç geliştirmeleri yaparak gerçek zamanlı veri takibi, kullanıcı yetkilendirme ve alarm yönetimi modüllerini uçtan uca geliştirdim.
  - GitHub Actions ile CI/CD pipeline kurulumu, Docker containerization ve deployment otomasyonu dahil DevOps operasyonlarını yönettim.

- **Boru Hatları İle Petrol Taşıma Anonim Şirketi (BOTAŞ)**  
  _Stajyer, Ankara_  
  **Tarih:** 07/2022 - 08/2022  
  **Açıklama:**
  - Yapay zeka ve görüntü işleme odaklı bir Android uygulama geliştirme projesinde yer aldım; Kotlin kullanarak mobil uygulama geliştirdim.
  - OpenCV ile görüntü işleme, TensorFlow Lite ve Google ML Kit ile yapay zeka model entegrasyonu gerçekleştirdim.
  - Mobil geliştirme yaşam döngüsü ve AI/ML model dağıtımı konularında uygulamalı deneyim kazandım.

### Eğitim

- **Gazi Üniversitesi**  
  _Bilgisayar Programcılığı, Önlisans_  
  **Tarih:** 17.08.2019 - 27.06.2022  
  **Açıklama:**
  - C# ve Java dilleriyle Nesne Yönelimli Programlama (OOP) ve algoritma tasarımı konularında uygulamalı projeler geliştirdim.
  - MS SQL Server ile ilişkisel veritabanı tasarımı ve T-SQL sorgulama yetkinliği kazandım.
  - Modern yazılım mimarilerine adaptasyon için güçlü bir teknik altyapı oluşturdum.

- **Fatma Yaşar Önen Mesleki ve Teknik Anadolu Lisesi**  
  _Muhasebe ve Finansman, Lise_  
  **Tarih:** 2013 - 2017

### Askerlik Durumu

Askerlik görevimi 2025 yılının kasım ayında tamamladım.

### Sertifikalar

- **Frontend Developer (React)**  
  _HackerRank_  
  **Link:** [hackerrank.com/certificates/48d222ff5e54](https://hackerrank.com/certificates/48d222ff5e54)

- **Node.js (Intermediate)**  
  _HackerRank_  
  **Link:** [hackerrank.com/certificates/9a63aba196f9](https://hackerrank.com/certificates/9a63aba196f9)

- **JavaScript (Intermediate) Certificate**  
  _HackerRank_  
  **Link:** [hackerrank.com/certificates/00d65b004f0d](https://www.hackerrank.com/certificates/00d65b004f0d)

- **REST API (Intermediate)**  
  _HackerRank_  
  **Link:** [hackerrank.com/certificates/602684d7fe43](https://hackerrank.com/certificates/602684d7fe43)

- **Software Architecture Foundations**  
  _LinkedIn_  
  **Link:** [linkedin.com/learning/certificates/7d3aeb5b229707c0e31cfdf59a66a52a816e1d8d135c91643efcff7372472423](https://www.linkedin.com/learning/certificates/7d3aeb5b229707c0e31cfdf59a66a52a816e1d8d135c91643efcff7372472423)

- **Hands-On AI: Implementing Agentic Systems**  
  _LinkedIn_  
  **Link:** [linkedin.com/learning/certificates/55ca2c12bb36682cdcf7f7f64b9d0ef84bd81deb094d88507b6780ff1a83a4ea](https://www.linkedin.com/learning/certificates/55ca2c12bb36682cdcf7f7f64b9d0ef84bd81deb094d88507b6780ff1a83a4ea)

- **CSS (Basic) Certificate**  
  _HackerRank_  
  **Link:** [hackerrank.com/certificates/2f51117fa2cf](https://www.hackerrank.com/certificates/2f51117fa2cf)

- **C# (Basic) Certificate**  
  _HackerRank_  
  **Link:** [hackerrank.com/certificates/7ac7d1982705](https://www.hackerrank.com/certificates/7ac7d1982705)

- **Learning Design Thinking**  
  _LinkedIn_  
  **Link:** [linkedin.com/learning/certificates/af61a5d6a352975bf8bccdb9b77b08034773ccfb6da5b5991448c689461617d1](https://www.linkedin.com/learning/certificates/af61a5d6a352975bf8bccdb9b77b08034773ccfb6da5b5991448c689461617d1)

## Archive Overview

The public archive currently contains 39 indexed records. The inventory below is generated from the site's content metadata and changes when content files are added or updated.

- **Blog posts:** 2
- **Technical gists:** 22
- **Projects:** 15
- **Content languages:** en (38), tr (1)

### Recurring Topics And Technologies

Tags are taken from published content metadata and indicate recurring subjects, tools, frameworks, and domains:

- TypeScript (11), automation (10), Docker (6), Next.js (5), React (5), .NET (4), Git (4), PostgreSQL (4), Self-Hosted (4), Bun (3), C# (3), Desktop Application (3), Developer Tools (3), DevOps (3), Documentation (3), JavaScript (3), PowerShell (3), TUI (3), webhooks (3), AI (2), Blazor (2), coolify (2), github (2), GitHub API (2), gotify (2), Job Search (2), MAUI (2), Mermaid (2), MUI (2), n8n (2), notifications (2), Open Source (2), Prettier (2), Prisma (2), Productivity (2), VS Code (2), AI Agents (1), Android (1), Anthropic (1), API Design (1), Application Tracking System (1), ASCII Art (1), ASP.NET Core (1), Audio Processing (1), Awesome List (1), Azure (1), Backup (1), Bash (1), Biome (1), Booking Platform (1), Bookmarking (1), Browser Extension (1), Build Tools (1), Calendar (1), calibre-web (1), Chrome Extension (1), CLI (1), Components (1), Containerization (1), Containers (1), Cross-Platform (1), Debugging (1), Developer Experience (1), Diagram Editor (1), Diagrams (1), Docker Compose (1), docker-compose (1), Document Conversion (1), Edgar Allan Poe (1), Electron.js (1), Environment Variables (1), ESLint (1), ffmpeg (1), File Conversion (1), File Matching (1), Firefox Extension (1), Fluent UI (1), Game Design (1), Git Hooks (1), Gitea (1), GitHub Actions (1), GitHub Pages (1), github-apps (1), Glob (1), Go (1), Google Gemini (1), Groq (1), guide (1), Handlebars (1), Hooks (1), Horror (1), html (1), HTML Widgets (1), Image Processing (1), Instagram (1), IntelliSense (1), Interactive (1), JSON (1), JSON Schema (1), LinkedIn (1), Linux (1), linuxserver (1), Literature (1), Live Preview (1), Material UI (1), mdx (1), Media Download (1), MinIO (1), Monaco Editor (1), Monorepo (1), Node.js (1), Obsidian (1), Ollama (1), OpenAI (1), OpenAPI (1), Patterns (1), PayloadCMS (1), Permissions (1), Plugin (1), Privacy (1), Product Requirements (1), Project Management (1), PWA (1), Python (1), Recruiting (1), Resume (1), Scripting (1), Scripts (1), Security (1), self-hosting (1), shadcn (1), Shell Scripting (1), Silent Hill (1), SMTP (1), Software Architecture (1), Software Development (1), SQL Server (1), SQLite (1), State Management (1), Static Site (1), Synchronization (1), Tasks (1), Technical Assessments (1), Terminal Application (1), Theming (1), tutorial (1), Type Safety (1), TypeORM (1), Types (1), TypeSpec (1), Userscript (1), Utility Types (1), Validation (1), Version Control (1), Video Processing (1), Visual Studio Code (1), VitePress (1), vitepress-plugin-mermaid (1), VSCode Extension (1), Web Scraping (1), Widget Manager (1), Widgets (1), Windows (1), Windows Forms (1), WPF (1), XAML (1)

## Start Here

- [Home](https://sametcc.me/index.md): Overview of the site and the latest content.
- [All content](https://sametcc.me/content.md): Combined archive of blog posts, gists, and projects.
- [Blog posts](https://sametcc.me/blog.md): Long-form writing, technical explanations, and essays.
- [Technical gists](https://sametcc.me/gist.md): Focused guides, references, scripts, and configuration examples.
- [Projects](https://sametcc.me/project.md): Software projects and project documentation.
- [About](https://sametcc.me/about.md): Canonical structured profile of Samet Can Cıncık.
- [Timeline](https://sametcc.me/timeline.md): Career and education timeline.
- [Skills](https://sametcc.me/skills.md): Technical skills, interests, and languages.
- [About / README](https://sametcc.me/readme.md): Public profile and background information from the author's GitHub README.
- [CV](https://sametcc.me/cv.md): Curriculum vitae.
- [Repositories](https://sametcc.me/repo.md): Public GitHub repositories for sametcn99.
- [Links](https://sametcc.me/link): Curated external links.
- [Support](https://sametcc.me/support): Ways to support the author.
- [Privacy policy](https://sametcc.me/privacy-policy.md): Privacy and analytics information.

## Blog Posts

- [Projeler İçin Ortak Developer ve AI Dokümantasyonu](https://sametcc.me/blog/projeler-icin-ortak-developer-ve-ai-dokumantasyonu.md): AI coding agent'larının ihtiyaç duyduğu proje bağlamını insanlar ve makineler için ortak, sürdürülebilir bir dokümantasyon yapısıyla oluşturmak. (Published: 2026-08-16; Type: post; Language: tr; Status: published; Tags: AI Agents, Documentation, Open Source, Software Architecture, Developer Experience)
- [Tracing Edgar Allan Poe's Ghost in the Fog of Silent Hill](https://sametcc.me/blog/tracing-edgar-allan-poes-ghost-in-the-fog-of-silent-hill.md): An analysis of the deep, foundational connections that bind Edgar Allan Poe's literary universe to the nightmarish town of Silent Hill. (Published: 2025-12-17; Type: post; Language: en; Status: published; Tags: Silent Hill, Edgar Allan Poe, Horror, Game Design, Literature)

## Technical Gists

- [GitHub Account Notifications to Gotify with n8n](https://sametcc.me/gist/github-account-notifications-to-gotify-with-n8n.md): A production-ready guide for delivering GitHub App events from every repository in an account to a Gotify phone notification channel. (Published: 2026-08-07; Type: gist; Language: en; Status: published; Tags: github, github-apps, gotify, n8n, webhooks, notifications, automation)
- [Coolify Notifications to Gotify with n8n](https://sametcc.me/gist/coolify-notifications-to-gotify-with-n8n.md): A production-ready guide for delivering Coolify deployment, backup, task, server, and container notifications to a Gotify phone notification channel. (Published: 2026-08-07; Type: gist; Language: en; Status: published; Tags: coolify, gotify, n8n, webhooks, notifications, self-hosting, automation)
- [shadcn Theme Configuration for MUI](https://sametcc.me/gist/shadcn-ui-for-mui.md): A complete MUI dark theme configuration styled to resemble shadcn's default dark theme, mapping zinc color tokens to MUI palette, typography, and component overrides. (Published: 2026-05-13; Type: gist; Language: en; Status: published; Tags: MUI, shadcn, React, Material UI, Theming)
- [How to Synchronize Obsidian Vault Using Git (PC + Android)](https://sametcc.me/gist/how-to-synchronize-obsidian-vault-using-git.md): A comprehensive, step-by-step guide on synchronizing your Obsidian vault across PC and Android devices using Git, covering setup, workflow, conflict resolution, and best practices. (Published: 2026-05-05; Type: gist; Language: en; Status: published; Tags: Obsidian, Git, Android, Synchronization, Backup)
- [Docker Usage Guide](https://sametcc.me/gist/docker-commands.md): Comprehensive guide to Docker commands for containerization, image management, and container orchestration with practical examples and best practices. (Published: 2024-08-25; Updated: 2026-04-27; Type: gist; Language: en; Status: published; Tags: Docker, Containers, DevOps, CLI, Containerization)
- [GitHub Repo TUI Cloner (PowerShell)](https://sametcc.me/gist/git-clone-repo-tui.md): An interactive PowerShell script to fetch and clone your owned GitHub repositories using a terminal UI (TUI). (Published: 2026-02-19; Type: gist; Language: en; Status: published; Tags: GitHub, PowerShell, TUI, Git, Automation)
- [TypeSpec for .NET and Next.js Teams](https://sametcc.me/gist/typespec-for-dotnet-nextjs.md): Practical TypeSpec workflow for contract-first API design with ASP.NET Core and Next.js, including OpenAPI generation and typed client usage. (Published: 2026-02-19; Type: gist; Language: en; Status: published; Tags: TypeSpec, .NET, Next.js, OpenAPI, API Design)
- [Rendering HTML Details/Summary in MDX with Custom Components](https://sametcc.me/gist/mdx-details-custom-components.md): A comprehensive guide on how to transform HTML details and summary elements into custom React components in Next.js MDX projects (Published: 2026-01-30; Type: gist; Language: en; Status: published; Tags: mdx, react, next.js, typescript, html)
- [Payload Docker Config: PostgreSQL + BunJS](https://sametcc.me/gist/payload-docker-config-pgsql-bunjs.md): Docker configuration files to run PayloadCMS using the Bun runtime and PostgreSQL database. (Published: 2025-12-25; Type: gist; Language: en; Status: published; Tags: PayloadCMS, Docker, Bun, PostgreSQL, Docker Compose)
- [Migrate from prettier-eslint to Biome](https://sametcc.me/gist/migrate-from-prettier-eslint-to-biome.md): A fully automated Bash script to migrate from ESLint + Prettier to Biome. It initializes Biome, migrates ESLint and Prettier configurations, removes old config files, and updates package.json scripts. Designed for Bun environments with full Next.js ESLint compatibility. (Published: 2025-12-24; Type: gist; Language: en; Status: published; Tags: Biome, ESLint, Prettier, JavaScript, Bun)
- [Insta Public Archiver](https://sametcc.me/gist/insta-public-archiver.md): A Python script to download all media from public Instagram profiles without login. (Published: 2025-12-23; Type: gist; Language: en; Status: published; Tags: Python, Instagram, Web Scraping, Media Download, Automation)
- [Deploying Calibre-Web on Coolify with Docker Compose](https://sametcc.me/gist/running-calibre-on-coolify.md): A comprehensive guide to deploying Calibre-Web on Coolify with Docker Compose and persistent storage (Published: 2025-10-15; Type: gist; Language: en; Status: published; Tags: coolify, docker, docker-compose, linuxserver, calibre-web, guide, tutorial)
- [Using JSON Schema in VS Code](https://sametcc.me/gist/using-json-schema-in-vscode.md): Step-by-step guide to implementing JSON Schema validation in VS Code for automatic error detection and IntelliSense support. (Published: 2024-08-25; Type: gist; Language: en; Status: published; Tags: VS Code, JSON Schema, Validation, IntelliSense, JSON)
- [TypeScript Types and Utility Types](https://sametcc.me/gist/typescript-types.md): Complete guide to TypeScript's built-in utility types, advanced type transformations, and custom type definitions for robust type safety. (Published: 2024-08-25; Type: gist; Language: en; Status: published; Tags: TypeScript, Types, Utility Types, Type Safety)
- [Using Glob Patterns in TypeScript Projects](https://sametcc.me/gist/typescript-glob-patterns.md): Comprehensive guide to glob patterns in TypeScript with detailed character explanations, examples, and practical applications for file matching. (Published: 2024-08-25; Type: gist; Language: en; Status: published; Tags: TypeScript, Glob, File Matching, Patterns, Developer Tools)
- [Product Requirements Document](https://sametcc.me/gist/product-requirement-doc-guide.md): Complete guide to writing effective Product Requirements Documents (PRDs) with templates, best practices, and real-world examples for software development. (Published: 2024-08-25; Type: gist; Language: en; Status: published; Tags: Product Requirements, Software Development, Documentation, Project Management)
- [React Component Lifecycle](https://sametcc.me/gist/react-component-lifecycle.md): Deep dive into React component lifecycle methods, hooks, and modern patterns for managing component state and side effects in React applications. (Published: 2024-08-25; Type: gist; Language: en; Status: published; Tags: React, JavaScript, Hooks, Components, State Management)
- [A Comprehensive Guide to Creating and Using Tasks in Visual Studio Code](https://sametcc.me/gist/using-tasks-in-vscode.md): Complete guide to VS Code tasks configuration including custom tasks, automation, debugging, and integration with build systems. (Published: 2024-08-25; Type: gist; Language: en; Status: published; Tags: VS Code, Tasks, Automation, Build Tools, Debugging)
- [Git Hooks: A Comprehensive Guide](https://sametcc.me/gist/git-hooks-guide.md): Complete guide to Git hooks implementation, best practices, and advanced automation techniques for client-side and server-side workflows. (Published: 2024-08-25; Type: gist; Language: en; Status: published; Tags: Git, Git Hooks, Automation, DevOps, Version Control)
- [Script Gists](https://sametcc.me/gist/scripts-gist.md): Collection of useful development scripts including Prettier setup, Git utilities, and automation tools for modern development workflows. (Published: 2024-08-25; Type: gist; Language: en; Status: published; Tags: Scripts, Prettier, Git, Automation, Developer Tools)
- [Running Scripts in Linux](https://sametcc.me/gist/running-scripts-in-linux.md): Essential guide to running scripts in Linux including permissions, execution methods, and best practices for shell scripting. (Published: 2024-08-25; Type: gist; Language: en; Status: published; Tags: Linux, Shell Scripting, Bash, Permissions, Automation)
- [PowerShell Scripting](https://sametcc.me/gist/powershell-scripting.md): Complete PowerShell scripting guide covering automation, DevOps practices, Azure integration, and advanced techniques for cross-platform environments. (Published: 2024-08-25; Type: gist; Language: en; Status: published; Tags: PowerShell, Scripting, Automation, DevOps, Azure)

## Projects

- [LinkedIn Hide Viewed Jobs](https://sametcc.me/project/linkedin-hide-viewed-jobs.md): A privacy-first browser tool that hides or highlights the job postings you have already viewed on LinkedIn, available as a userscript or a standalone browser extension for Chrome and Firefox. (Published: 2026-07-22; Type: project; Language: en; Status: published; Tags: TypeScript, Browser Extension, Userscript, LinkedIn, Job Search, Chrome Extension, Firefox Extension, Privacy)
- [My Stars Atlas](https://sametcc.me/project/my-stars-atlas.md): A generated, searchable catalog of starred GitHub repositories grouped into stable categories, built with a deterministic classification engine and published as a static site on GitHub Pages. (Published: 2026-07-20; Type: project; Language: en; Status: published; Tags: TypeScript, GitHub API, GitHub Pages, GitHub Actions, Handlebars, Static Site, Awesome List, Automation)
- [Application Tracker](https://sametcc.me/project/application-tracker.md): A self-hosted job search operating system that keeps applications, company notes, follow-ups, documents, and progress history together in a single private dashboard. (Published: 2026-05-15; Type: project; Language: en; Status: published; Tags: TypeScript, Next.js, Prisma, PostgreSQL, Docker, Self-Hosted, Job Search, Application Tracking System, MinIO)
- [Hiretea](https://sametcc.me/project/hiretea.md): A self-hosted platform for running technical assessments end to end, bundling Gitea as the code host and PostgreSQL as the data store with no external SaaS dependencies. (Published: 2026-04-15; Type: project; Language: en; Status: published; Tags: TypeScript, Next.js, Prisma, PostgreSQL, Gitea, Docker, Self-Hosted, Technical Assessments, Recruiting)
- [Booking Calendar (Self-Hosted)](https://sametcc.me/project/booking-calendar.md): A self-hosted PWA designed for single-admin appointment management, running on your own server with shareable booking links, smart notifications, and integrations for webhooks, CalDAV, and iCal. (Published: 2026-04-04; Type: project; Language: en; Status: published; Tags: TypeScript, React, Bun, TypeORM, SQLite, PWA, Self-Hosted, Calendar, Booking Platform, Webhooks, SMTP)
- [DreamTUI](https://sametcc.me/project/dreamtui.md): A terminal-based generative dream engine that transforms written dreams into full-screen, animated ASCII art experiences using a two-stage AI pipeline. (Published: 2026-03-17; Type: project; Language: en; Status: published; Tags: TypeScript, TUI, ASCII Art, AI, OpenAI, Anthropic, Google Gemini, Groq, Ollama, Terminal Application)
- [HTWind](https://sametcc.me/project/htwind.md): A highly customizable, HTML-based widget manager for Windows built with .NET and WPF, bringing web tools and system helpers directly to your desktop with native PowerShell execution support. (Published: 2026-03-15; Type: project; Language: en; Status: published; Tags: C#, .NET, WPF, XAML, HTML Widgets, Desktop Application, Windows, PowerShell, Fluent UI, Widget Manager)
- [ArcDrop](https://sametcc.me/project/arcdrop.md): A self-host-first bookmarking platform with cross-platform desktop clients and AI-assisted organization, built as a .NET 10 monorepo with MAUI, Blazor, and ASP.NET Core. (Published: 2026-03-10; Type: project; Language: en; Status: published; Tags: C#, .NET, ASP.NET Core, Blazor, MAUI, PostgreSQL, Docker, Self-Hosted, Bookmarking, AI, Monorepo)
- [Golter](https://sametcc.me/project/golter.md): A terminal-based file converter with a modern TUI, built with Go. Supports batch conversion of images, videos, audio, and documents. (Published: 2026-01-17; Type: project; Language: en; Status: published; Tags: Go, TUI, File Conversion, ffmpeg, Image Processing, Video Processing, Audio Processing, Document Conversion)
- [GitHub Profile Viewer](https://sametcc.me/project/github-profile-viewer.md): A dynamic web platform that transforms how you explore GitHub profiles, built with Blazor and .NET. Dive deep into developers' open-source contributions with a sleek interface and robust performance. (Published: 2025-10-15; Type: project; Language: en; Status: published; Tags: Blazor, .NET, GitHub API, Open Source, Developer Tools)
- [Mermaid Live Editor & Viewer](https://sametcc.me/project/mermaid-viewer.md): A powerful web application built with Next.js, React, and TypeScript that allows users to create, edit, and share Mermaid diagrams in real-time with live preview and instant sharing capabilities. (Published: 2025-04-23; Type: project; Language: en; Status: published; Tags: Next.js, React, TypeScript, Mermaid, Monaco Editor, MUI, Diagram Editor, Live Preview)
- [VitePress Mermaid Renderer](https://sametcc.me/project/vitepress-mermaid-renderer.md): A VitePress plugin that transforms static Mermaid diagrams into interactive, dynamic visualizations with zoom, pan, fullscreen, and more. (Published: 2025-03-15; Type: project; Language: en; Status: published; Tags: VitePress, Mermaid, Plugin, Documentation, Diagrams, Interactive, JavaScript, TypeScript, vitepress-plugin-mermaid)
- [Env Protector](https://sametcc.me/project/env-protector.md): A Visual Studio Code extension that enhances the security of environment files by masking sensitive data, providing confirmation prompts before opening, and allowing users to manage environment variables without exposing their contents. (Published: 2024-09-14; Type: project; Language: en; Status: published; Tags: Visual Studio Code, VSCode Extension, Environment Variables, Security, Productivity)
- [Electron Widgets](https://sametcc.me/project/electron-widgets.md): A desktop application built with Electron.js and Node.js that allows users to create and manage customizable widgets on their desktops. (Published: 2024-03-25; Type: project; Language: en; Status: published; Tags: Electron.js, Node.js, Desktop Application, Widgets, Cross-Platform)
- [Resume Builder](https://sametcc.me/project/resume-builder.md): A desktop application developed with C# and Windows Forms that allows users to create, manage, and export resumes using various templates, with features like automatic saving, import/export, and multi-language support. (Published: 2023-01-12; Type: project; Language: en; Status: published; Tags: C#, Windows Forms, SQL Server, Resume, Desktop Application, Productivity, MAUI)

## Machine-Readable Content

- [OpenAPI document](https://sametcc.me/openapi.json): OpenAPI description of the public HTTP API.
- [JSON Feed](https://sametcc.me/feed.json): JSON Feed 1.1 containing posts, gists, and projects.
- [RSS feed](https://sametcc.me/rss.xml): RSS feed of the latest content.
- [Sitemap](https://sametcc.me/sitemap.xml): XML sitemap containing public site URLs.
- [API catalog](https://sametcc.me/.well-known/api-catalog): Linkset metadata connecting API resources to OpenAPI and human documentation.
- [ACP discovery](https://sametcc.me/.well-known/acp.json): Agent Communication Protocol discovery metadata.
- [A2A Agent Card](https://sametcc.me/.well-known/agent-card.json): Agent-to-agent discovery metadata for the public profile and content agent.
- [MCP Server Card](https://sametcc.me/.well-known/mcp/server-card.json): MCP HTTP server discovery metadata.
- [Agent skills index](https://sametcc.me/.well-known/agent-skills/index.json): Discoverable agent skill metadata for reading website content.
- [Web Bot Auth key directory](https://sametcc.me/.well-known/http-message-signatures-directory): Public JWK directory for HTTP Message Signatures request signing.
- [Agent authentication documentation](https://sametcc.me/auth.md): Authentication and agent access documentation.
- [Full agent context](https://sametcc.me/llms-full.txt): Full Markdown context containing profile, published content, and a GitHub repository snapshot.

## Content API

All API responses are JSON unless otherwise noted. The `section` path parameter accepts `posts`, `gists`, or `projects`; individual slugs contain lowercase letters, numbers, hyphens, or underscores.

- `GET https://sametcc.me/api/content/all`: Return metadata for all public content.
- `GET https://sametcc.me/api/content/search?q={query}&section={section}`: Search public content.
- `GET https://sametcc.me/api/content/{section}`: Return all content items in a section.
- `GET https://sametcc.me/api/content/{section}/{slug}`: Return one content item by section and slug.
- `GET https://sametcc.me/api/content/cv`: Return the CV content as rendered HTML.
- `GET https://sametcc.me/api/readme`: Return the public GitHub README as rendered HTML.
- `GET https://sametcc.me/api/repos`: Return public GitHub repositories for `sametcn99`.
- `GET https://sametcc.me/api/profile`: Return the canonical structured author profile.
- `GET https://sametcc.me/api/about`: Alias for the canonical author profile.
- `GET https://sametcc.me/api/timeline`: Return work and education timeline entries.
- `GET https://sametcc.me/api/skills`: Return skills, areas of interest, and languages.
- `GET https://sametcc.me/api/profile/github`: Return the public GitHub repository snapshot.
- `GET https://sametcc.me/health`: Return application health status.

## Agent Access

- Request `Accept: text/markdown` or use an explicit `.md` suffix for agent-friendly Markdown from `/`, `/blog`, `/gist`, `/project`, `/content`, `/repo`, `/cv`, `/readme`, `/about`, `/profile`, `/timeline`, `/skills`, `/privacy-policy`, `/support`, and individual content pages.
- Use `/llms-full.txt` when a complete profile and content context is needed; use `/llms.txt` first for navigation and source selection.
- MCP clients can use the read-only Streamable HTTP transport at `/mcp`; initialize first, then use `resources/list`, `resources/read`, `tools/list`, and typed tools including `get_profile`, `list_projects`, `get_content`, `search_content`, `get_timeline`, `get_skills`, `list_taxonomy`, and `get_related_content`.
- Prefer the specific content URL over scraping navigation or rendered HTML.
- Prefer `/api/content/{section}/{slug}` when structured metadata is sufficient; prefer the Markdown page when the full article or guide is needed.
- Treat content as public reference material and do not infer private personal information beyond what the linked public pages explicitly state.
- Content can change over time. Use publication and modification metadata from the page or API response when recency matters.

## Scope And Attribution

This index covers the public content intentionally exposed by the site. Third-party links, GitHub repository data, external services, and generated feeds remain subject to their respective owners' terms and availability.