ryotapoi

Claude Code 開発プロジェクト構成

Claude Code + Codex MCP を使った開発プロジェクトの標準的なフォルダ構成と開発フロー。 AIエージェント開発の情報管理-原則 のフォルダ構成をベースに、Claude Code のシステム上の制約を組み合わせたもの。

フォルダ構成

原則のフォルダ構成をそのまま採用し、Claude Code 固有の設定ファイル群（.claude/, CLAUDE.md）を追加する。

ryotapoi

AI エージェント開発の情報管理 - 原則

AI コーディングエージェントを前提とする開発プロジェクトの情報管理原則とフォルダ構成。 特定のツール（Claude Code, GitHub Copilot 等）に依存しない一般論。

スコープ: 情報の分類・配置・管理の原則。 プロジェクト管理（スケジュール、タスク管理等）は扱わない。

関連: AIエージェント開発の情報管理-設計根拠（各原則の背景と根拠）

ryotapoi

Markdown 記法ルール

この Markdown 記法ルールに従って、Markdown 文書を作成・修正してください。

---

1. 見出し

ルール

ryotapoi

//
//  AlertController.swift
//
//  Created by ryotapoi on 2025/01/20.
//

import UIKit

/// Represents an action displayed in an alert.
///

ryotapoi

class ToastWindow: UIWindow {
    override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
        let view = super.hitTest(point, with: event)
        if view == self {
            return nil
        } else {
            return view
        }
    }
}

ryotapoi

import Foundation
import zlib

struct CRC32: Equatable, ExpressibleByIntegerLiteral, CustomStringConvertible {
    typealias IntegerLiteralType = UInt32
    
    let value: UInt32
    var description: String { String(format: "%08X", value) }

    init(data: Data) {

ryotapoi

import Foundation
import Combine

extension Combine.Publishers {
    struct Sequencial<Sequence, Output, Failure>: Publisher
    where
        Sequence: Swift.Sequence,
        Sequence.Element: Publisher,
        Sequence.Element.Output == Output,
        Sequence.Element.Failure == Failure

ryotapoi

import Foundation
import Combine

extension FileManager {
    struct RemoveItemPublisher: Publisher {
        typealias Output = Void
        typealias Failure = Error
        
        var url: URL
        var fileManager: FileManager

ryotapoi

import Foundation

let formatter = DateComponentsFormatter()
formatter.unitsStyle = .positional
formatter.allowedUnits = [.minute, .second]
formatter.zeroFormattingBehavior = .pad

formatter.string(from: 61)

ryotapoi

zip -0 -r archive.zip source…