<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/social-preview-dark.png">
<img src="https://raw.githubusercontent.com/erayendes/kortext/HEAD/docs/assets/social-preview.png" alt="Kortext — the project brain for AI-driven development" width="880">
</picture>
</p>
<p align="center">
<a href="https://www.npmjs.com/package/kortext"><img alt="npm" src="https://img.shields.io/npm/v/kortext.svg"></a>
<a href="https://github.com/erayendes/kortext/releases"><img alt="Kortext.app" src="https://img.shields.io/github/v/release/erayendes/kortext?include_prereleases&label=Kortext.app&logo=apple&logoColor=white"></a>
<a href="https://github.com/erayendes/kortext/actions/workflows/kortext-ci.yml"><img alt="CI" src="https://github.com/erayendes/kortext/actions/workflows/kortext-ci.yml/badge.svg"></a>
<img alt="Node" src="https://img.shields.io/node/v/kortext">
<a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg"></a>
<a href="https://milowda.com"><img alt="Yerli üretim" src="https://img.shields.io/badge/YERL%C4%B0%20%C3%9CRET%C4%B0M-red?style=flat&label=%F0%9F%A4%9D&color=red&link=https%3A%2F%2Fmilowda.com"></a>
</p>
🇹🇷 터키어 언론용
AI를 사용하여 제품을 만들면서, 저는 항상 같은 두 가지 벽에 부딪혔습니다. 바로 프로젝트가 어디에 서 있는지 알 수 없다는 점과, 어느 순간 모델이 우리가 합의했던 규칙들을 무시하고 스스로 행동하기 시작한다는 점입니다.
당신도 같은 문제를 가지고 있다는 것을 압니다. 다만 아직 이름을 붙이지 않았을 뿐입니다.
저는 그 이름을 알았습니다. 그것은 바로 Kortext입니다.
Kortext는 개발이 시작되기 전에 AI와 합의하는 **제품 헌법(product constitution)**과 같습니다.
사용자가 제공하는 **BRIEF.md**를 바탕으로, **10명의 전문가 페르소나(expert personas)**가 **14개의 아키텍처 문서(architecture documents)**를 작성합니다. 이는 모델이 매번 돌아오는 유일한 진실의 원천입니다. 만약 사용자가 작성한 브리프가 충분하지 않다면, Kortext가 그렇게 알려줍니다. 이 패널은 BRIEF.md를 설명하고 예시를 제공합니다.
인간 역할은 하나, **Prime**가 있습니다. 다른 페르소나는 다음과 같습니다: product manager, architect, designer, growth expert, security engineer, DevOps engineer, DBA, compliance expert, copywriter, 그리고 QA engineer.
Kortext는 브리프(brief)를 바탕으로 PRODUCT.md, STACK.md, STRUCTURE.md, ARCHITECTURE.md, DESIGN.md, GROWTH.md, SECURITY.md, ENVIRONMENT.md, DATABASE.md, API.md, LEGAL.md, CONTENT.md, ENGINEERING.md, TEST.md를 생성합니다. 그리고 마지막에는 선택 사항인 EXPERIENCE.md와 그 안에 포함된 PROMPTS.md가 있습니다.
<p align="center">
<img src="https://raw.githubusercontent.com/erayendes/kortext/HEAD/docs/assets/panel-documents.png" alt="The analysis in flight: documents in their groups, each with its author and state" width="880">
</p>
작성된 모든 문서는 검토를 위해 당신 앞에 놓입니다. 건너뛰지 마세요. 읽으세요. 믿어주세요, 그럴 가치가 있습니다.
문서에는 당신에게 제기된 질문, 이전에 작성된 문서에 대한 변경 요청(change request), 또는 아직 작성되지 않은 문서에 대한 메모가 포함될 수 있습니다. 이는 모델 자체의 발견 사항입니다.
그 옆에서 당신은 아무 줄이나 선택하고 질문을 하거나 변경을 요청할 수 있습니다.
만약 모델이 문서의 변경을 요구하고 당신이 이를 수락하면, 해당 문서는 파이프라인(pipeline)을 다시 거치게 됩니다. 문서들이 서로 의존하기 때문에, 때로는 루프처럼 하나의 문서가 여러 번 당신에게 돌아올 수 있습니다. 이는 상당한 양의 토큰(tokens)을 소모합니다. 하지만 이는 나중에 낭비될 수 있었던 시간과 토큰보다 먼저 소모되는 것입니다. 전반적으로 훨씬 더 좋은 거래입니다.
작성이 완료되면, 당신의 프로젝트 폴더에는 .kortext 디렉토리가 생기고 그 안에 제품 헌법(product constitution)이 담깁니다.
그 이후부터는 당신이 이미 사용하고 있는 어떤 AI 도구든, 어떤 클라이언트에서든 계속 구축 작업을 진행할 수 있습니다. 이때 Kortext의 역할은 끝납니다. 로그인도 없고, 키도 없고, API 연결도 없습니다. Kortext는 아무것도 수집하지 않으며 텔레메트리(telemetry)를 저장하지 않습니다. 비록 얼마나 많이 사용될지 매우 궁금하지만 — 만약 그런 일이 발생하더라도 익명으로 처리되므로 걱정할 필요가 없습니다.
그리고 저는 이미 진행 중인 프로젝트들을 잊지 않았습니다. Kortext는 기존 코드베이스(codebase)에서도 시작할 수 있으며, 프로젝트가 어느 단계에 있는지에 대한 제안을 제공할 수도 있습니다.
저는 저녁 시간에 혼자서 Kortext를 만들고, MIT 라이선스(MIT) 하에 배포합니다.
만약 이것이 귀하의 프로젝트에 적절한 가이드가 되었다면, 그것이 제가 바라던 바입니다. 당신의 제품들이 훌륭하기를 바랍니다.
MIT © Eray Endes
INSTALL · GUIDE · MACOS · SUPPORT · SECURITY · CHANGELOG
