Agentic IDE

Agentic IDE is a graduation project and research prototype for a safety-oriented AI coding environment. The project focuses on a plan-first, approval-gated agent loop: the assistant inspects the codebase, proposes a change plan, shows a diff, waits for human approval, applies only approved edits, and keeps rollback/audit information.

Current Status

This repository is currently in the thesis planning and requirements phase. The main artifacts are research notes, architecture decisions, safety design, evaluation planning, and GitHub Project seed data. Implementation work will start from the Electron + Monaco + TypeScript stack described in the project documents.

Core Documents

• Supervisor brief
• Product plan
• Verification-Driven Development planning draft
• System plan
• Architecture options
• Implementation readiness
• Pre-implementation audit
• Quality gates
• VS Code workspace analysis
• GitHub Project operations
• Glossary
• Threat model
• Architecture decision records
• Agent architecture analysis
• Safety and guardrails
• Testing and CI
• Evaluation plan
• Project roadmap
• Thesis outline

GitHub Project Seed

The requirements backlog is defined in github-projects/requirements-analysis.json. The setup script creates labels, a GitHub Project, custom fields, epics, and requirement issues.

Dry run:

powershell -ExecutionPolicy Bypass -File .\scripts\setup-requirements-github-project.ps1 -Owner TurkishKEBAB -DryRun

Create or update the live project:

powershell -ExecutionPolicy Bypass -File .\scripts\setup-requirements-github-project.ps1 -Owner TurkishKEBAB

Repository Governance

The repository includes a lightweight governance CI workflow that validates:

• required GitHub metadata files
• the requirements project seed JSON
• the GitHub Project setup dry run
• common accidental secret or local IDE path patterns

Run it locally:

powershell -ExecutionPolicy Bypass -File .\scripts\validate-github-governance.ps1 -Owner TurkishKEBAB

Planned Tech Stack

• Electron
• Monaco Editor
• TypeScript
• Vitest
• Playwright for Electron E2E tests
• Local-first safety boundaries with optional cloud model providers

License

No open-source license has been selected yet. Until a license is added, all rights are reserved by the repository owner.